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PREFACE 


This manual describes the Common Assembly Language/32 (CAL/32). 
Chapter 1 is an introduction to the basic concepts of the 
assembler, central processing unit (CPU) and main memory. Also 
described are the instruction formats for 16- and 32-bit 
machines, as well as variations in the formats. Chapter 2 
introduces assembly language symbolic representation and 
describes symbolic values. Chapter 3 defines the source program 
and contains a list of machine instructions, mnemonics’ and 
detailed descriptions of assembler instructions. Common mode 
programming and common mode operations are explained in Chapter 
4. CAL/32 operating instructions are listed in Chapter 5. 


Appendix A contains CAL/32 error codes. Appendix B describes the 
16- and 32-bit object code formats. 


The FOO RO3 version of this manual includes descriptions of new 
machine instructions for use with the 3280 System. 


Included in this release of OS/32 is a new START option that 
assembles user created source programs over sixty percent faster 
than the standard method of assembly. A description of the high 
performance method (HPM) of assembly is found in Chapter 5. 
Included in this section is a description concerning optimization 
of the CAL/32 assembler. 


The 3200MPS Family of Processors features identified throughout 
the manual are applicable to the 3200MPS Family of Processors 
only. This manual is intended for use with the 0OS/32 R08.2 
software release and higher. 
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CHAPTER 1 
BASIC CONCEPTS 


1.1 INTRODUCTION 


Like all assemblers, Common Assembly Language/32 (CAL/32) 
simplifies the direct control of the processor by providing the 
programmer with a way of representing actual machine operations 
in an easily understood symbolic form. Assemblers translate 
symbolic representations of machine instructions into binary form 
to be executed by the processor. CAL/32 also includes’ such 
features as relocation, segmentation, complex data definitions 
and expression analysis. CAL/32 can run on any 32-bit processor 
and produce machine code for any 32-bit processor. 


Because assembly language programming is so close to actual 
machine operations, it is essential that the assembly language 
programmer have a good understanding of system architecture. 
This chapter contains introductory architectural descriptions for 
uniprocessing systems and multiprocessing systems. See the 
appropriate Processor User Manual or Instruction Set Reference 
Manual for more detailed information. 


1.2 THE PROCESSOR 

The main components of a processor are the central processing 

unit (CPU) and main memory. All processors, whether ina 

uniprocessing or a multiprocessing system, are stored-program, 

multiregister machines. | 

There are three iterations of the processor: 

e A standard processor for a uniprocessing system. Figure 1-1 
depicts the configuration of a typical uniprocessing system. 

e A CPU in a multiprocessing system. 

e Up to nine auxiliary or input/output processing units (APUs or 


IOPs) in a multiprocessing system. Figure 1-2 depicts’ the 
configuration of a typical multiprocessing system. 
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Figure 1-1 Configuration of a Typical Uniprocessing System 
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Figure 1-2 Configuration of a Typical Multiprocessing System 
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In addition to the standard tasks performed by the operating 
system in a uniprocessing system, the operating system in a 
multiprocessing system 

e controls all APUs, 

@e monitors all activity in the multiprocessing system, 

e services all APU exceptions, 


e dispatches application tasks created for existing CPUs or the 
CPU in the 3200MPS Family of Processors, and 


e dispatches tasks to the APUs and IOPs for execution in the 
3200MPS Family of Processors, 


The function of an APU is to execute tasks concurrently with the 
CPU and other APUs. The function of the IOP is to handle all 
input/output (I/0) devices configured under it, thereby relieving 
the CPU of I/O overhead. 

1.2.1 Temporary Storage (Registers) 

All processors have some amount of temporary storage that can be 
used aS accumulators or index registers. There are three types 
of temporary storage: 

e General-purpose registers 


e Single precision floating point registers (SPFPR) 


@ Double precision floating point registers (DPFPR) 


All processors have at least one set of 16 general-purpose 


registers. In the 16-bit processors, each general-purpose 
register holds 16 bits; in the 32-bit processors, each holds 32 
bits. General-purpose registers can be used for integer 


arithmetic, address arithmetic, logical operations and character 
operations. Floating point registers are used only for floating 
point arithmetic operations. Processors with floating point 
registers have either eight single precision registers, or eight 
single precision registers and eight double precision registers. 
The single precision registers hold 32 bits. The double 
precision registers hold 64 bits. 


For a multiprocessing system, there are up to ten sets of 
registers; one for each of the nine APUs that can be part of the 
system, plus a set in the CPU; (i.e., ten machines each having 16 
general register sets, eight SPFPR and eight DPFPRs). 
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1.2.2 Program Status Word (PSW) 


The PSW defines the current state of a processing unit. The 
uniprocessing system has one current PSW. Since the 3200MPS 
Family of Processors consists of multiple processors, there is 
one current PSW for each processor. The PSW consists of three 
major parts: 


e Status descriptor 
@e Condition code (CC) 


e Location counter (LOC) 


Individual bits and bit fields within the status descriptor 
portion of the PSW define the current state of interrupts and 
various hardware features of the processor. By setting or 
resetting bits within the status descriptor, the programmer can 
enable or disable such interrupts as I/O, arithmetic fault and 
machine malfunction. On those processors with multiple sets of 
general-purpose registers, a field in the status descriptor 
defines which set is currently in use. Programmers writing user 
level programs, as opposed to operating system or stand-alone 
programs, cannot directiy access the status descriptor. In this 
case, the operating system maintains control of interrupts and 
registers. 


The CC provides a means of controlling program flow, based on the 
results of instruction execution. As certain instructions are 
executed, the value in the CC changes to indicate the nature of 
the result. For example, if an operation produces a zero result, 
the CC may be changed to a zero value. With branch instructions, 
the programmer can test the value in the CC and branch or not, 
depending on that value. Not all instruction executions affect 
the CC. See the appropriate processor reference manual for more 
details. 


The LOC controls the order of instruction execution. Normally, 
the processor executes instructions sequentially and uses the LOC 
to keep track of where the instructions are in main memory, then 
fetches the instruction from the memory location specified by the 
address contained in the LOC. It increments the LOC by the 
length of the instruction, executes the instruction and fetches 
the next instruction. Branch instructions, when executed, change 
the contents of the LOC and, thereby, affect the branch. 


In 32-bit machines, the PSW contains 64 bits; the least 
Significant 24 bits are reserved for the LOC, In 16-bit 
machines, the PSW contains 32 bits; the least significant 16 bits 
are reserved for the LOC. 
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1.2.3 Input/Output (1/0) Interface 


The execution of certain machine instructions allows the 
programmer to control external devices and to cause the transfer 
of data between external devices and main memory or registers. 
The actual programming of I/O operations is very much dependent 
upon the hardware of both the processor and the peripherals. I/0 
instructions are restricted to operating systems and stand-alone 
programs. User programs can communicate with I/O devices through 
facilities provided by the operating system. 


1.2.3.1 Main Memory 


To the assembly language programmer, main memory appears as a 
block of contiguous storage locations. The smallest unit of 
memory the programmer can access is the byte (eight bits). The 
programmer can also access halfwords (two bytes), fullwords (four 
bytes) and doublewords (eight bytes). Each byte in memory is 
accessed by a unique address. Memory addresses start with zero 
and are incremented by one for each succeeding byte. Memory 
addresses in the 32-bit processors always consist of 24 bits. In 
the 16-bit processors, memory addresses consist of 16 bits. When 
accessing bytes, any memory address within the limits of the 
particular hardware configuration is considered valid. Halfwords 
must be accessed with halfword addresses. Fullwords must be 
accessed with addresses that are multiples of four. Doublewords 
must be accessed with addresses that are multiples of eight. 


1.2.4 Software Relocation 


Programs written in CAL/32 can be absolute or relocatable. An 
absolute program is one whose origin (starting location) is 
specified at assembly time as being at a fixed halfword location 
in memory. Subsequent addresses within the program, whether 
referring to instructions or data, are fixed at assembly time. 
For execution, absolute programs must always’ be loaded into 
memory at the location specified as the origin. This type of 
programming is useful in stand-alone applications and some 
operating system situations. A user program written with 
absolute addresses is relocatable, but the addresses that are 
used refer to their absolute values relative to task address 0. 
It is the actual location of this task, 0, which is relocatable. 


Relocatable programs can be loaded for execution beginning at any 
halfword location in memory. The origin of a relocatable program 
is assumed to be relocatable zero. The CAL/32 output for this 
type of program specifies all addresses in the program as 
relative displacements from the origin. At link time, the 
linkage editor resolves all addresses within the program by 
adding a relocation value (the actual memory address for the 
start of the program) to the relative addresses supplied by 
CAL/32. Relocation applies only to addresses within the program. 
Relocatable programs can contain absolute data. 
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1.2.5 Hardware Relocation 


Some processors and their operating systems support hardware 
relocation and segmentation. Programs prepared for these systems 
start out as relocatable. A linkage editor processes the 
relocatable output from CAL/32 to link in any needed subprograms. 
The output of this process is an absolute program that, because 
of the relocating hardware, can. be loaded beginning at any memory 
address that is a multiple of 256 for memory access controller 
(MAC) machines or 2,048 for memory address translator (MAT) 
machines. At run-time, the nelocating hardware adds the required 
relocation value to all addresses supplied by the program. This 
relocating hardware also provides for program segmentation, where 
the program is divided into pieces that can be loaded into 
noncontiguous blocks of memory. | 


CAL/32 supports segmentation by allowing the programmer to divide 
the program into pure and impure segments. The pure segment of 
a program consists of machine instructions and constant data and 
cannot be modified at run-time. (The operating system and the 
hardware prevent modification.) The impure segment consists of 
the data base which can be modified at run-time. Programs 
prepared aS pure and impure segments can be shared (executed 
concurrently) by several users. Only one copy of the pure 
segment resides in memory during execution while there is one 
copy of the impure segment for each user. 


1.3 INSTRUCTION FORMATS (16-BIT) 


The 16-bit processors have four types of machine instructions: 
register-to-register (RR), register and indexed storage (RX), 
register and immediate (RI) and short form (SF). The following 
abbreviations illustrate the instruction formats: 


OP Operation 

Rl First operand register 

R2 Second operand register 

N A 4-bit immediate value 

X2 Second operand index register 

A2 Second operand direct address 

I2 Second operand immediate value 


Most instructions require two operands, the first of which is 
contained in a register. The result usually replaces’ the 
contents of the first operand register. Exceptions to these 
rules are noted in Section 1.5. 


1.3.1 Register-to-Register (RR) Instructions 
RR instructions cause operations to take place between operands 


contained in registers. RR instructions are 16 bits long, as 
shown in Figure 1-3. 
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BITS: O 78 11 12 15 


Figure 1-3 RR Format (16-Bit) 


The first eight bits of the instruction define the operation. 
The next four bits identify the first operand register. The 
final four bits identify the second operand register. In most RR 
instructions, the specified operation takes place between the 
contents of the first operand register and the contents of the 
second operand register. The result of the operation replaces 
the contents of the first operand register. 


1.3.2 Register and Indexed Storage (RX) Instructions 


RX instructions cause an operation to take place between a first 
operand, contained ina register, and a second operand, located 
in main memory. These instructions require 32 bits, as shown in 
Figure 1-4, 
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BITS: 0 78 14:12 15 16 31 


Figure 1-4 RX Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register and the next four bits 
identify an optional index register. The remaining 16 bits 
specify an address in main memory. The operation takes place 
between the contents of the first operand register and the 
contents of the memory location specified. The actual address of 
the second operand is determined by adding the contents of the 
index register to the contents of the address field. If the 
index field of the instruction contains zero, no indexing takes 
place. In most cases, the result of the operation replaces the 
contents of the first operand register. y 
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1.3.3 Register and Immediate (RI) Instructions 


RI instructions cause operations to take place between the 
contents of a register and the contents of an immediate field 
embedded in the instruction itself. They are 32 bits long, as 
shown in Figure 1-5. 
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BITS: O 78 11 12 15 16 31 


Figure 1-5 RI Format (32-Bit) 


The first eight bits specify the operation; the next four bits 
identify the first operand register; the next four bits identify 
an optional index register; the final 16 bits are the immediate 
value. The first operand is the contents of the first operand 
register. The second operand is obtained by adding the contents 
of the index register to the contents of the immediate field. If 
the index field contains zero, no addition takes place. The 
result of the operation usually replaces the contents of the 
first operand register. 


1.3.4 Short Form (SF) Instructions 


SF instructions are variations on the RI instructions in which 
the second operand is small enough to be expressed in four bits. 
SF instructions require 16 bits, as shown in Figure 1-6. 
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BITS: 0 78 11 12 15 


Figure 1-6 SF Format (16-Bit) 


The first eight bits indicate the operation. The next four bits 
identify the first operand register and the 4-bit immediate 
field. The next four bits contain the immediate value. 
Operations take place between the contents of the first operand 
register and the 4-bit immediate operand. The result of the 
operation usually replaces the contents of the first operand 
register. 
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1.4 INSTRUCTION FORMATS (32-BIT) 


The 32-bit processors recognize seven different types of 
instructions. They are: RR, three variations on RX, two 
variations on RI, and SF. The following abbreviations are used 
to illustrate instruction formats: 


OP Operation 


Rl First operand register 

R2 Second operand register 

N A 4-bit immediate value 

X2 Second operand single index register 
D2 Second operand displacement 


FX2 Second operand first. .index register 
SX2 Second operand second index register 


A2 Second operand direct address 

I2 Second operand immediate value 
Ll Length of first operand string 
L2 Length of second operand string 


Most instructions require two operands. The first is the 
contents of a register. The result of the operation usually 
replaces the contents of the first operand register. Exceptions 
to these rules are noted in Section 1.5. 


1.4.1 Register-to-Register (RR) Instructions 


The format and function of these instructions are the same as for 
the 16-bit processors, They cause operations to take place 
between operands contained in registers and they require 16 bits. 
These instructions are shown in Figure 1-7. 


Figure 1-7 RR Format (32-Bit) 


The first eight bits specify the operation. The next four bits 
identify the first operand register and the last four bits 
identify the second operand register. The processor performs the 
indicated operation between the contents of the first operand 
register and the contents of the second operand register. In 
most RR instructions, the result replaces the contents of the 
first operand register. 
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1.4.2 Register and Indexed Storage One (RX1) Instructions 


RX1 instructions define an operation between the contents of a 
register and the contents of a main memory location. They 
require 32 bits, as shown in Figure 1-8. 


050-8 


Es ec 


BITS: 0 78 14 12 15161718 31 


Figure 1-8 RX1 Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register and the next four bits 
identify the optional index register. The next two bits, 16 and 
17, must be zeros. The next 14 bits constitute a direct program 
address in a range from 0 to 16,383. 


The address of the second operand is obtained by adding the 
contents of the index register to the contents of the 14-bit 
address field. If the index register field contains zero, this 
addition does not take place and the contents of the address 
field are used as the address. The operation takes place between 
the contents of the first operand register and the contents of 
the specified memory location. The result usually replaces the 
contents of the first operand register. 


1.4.3 Register and Indexed Storage Two (RX2) Instructions 

RX2 instructions define operations between the contents of a 
register and the contents of a location in main memory. RX2 
instructions are like the RX1l instructions; they require 32 bits. 


They differ from the RX1 instructions in the method of 
calculating the second operand address. See Figure 1-9. 


050-9 
| op [ref xeh] oe 


BITS: 0 78 11 12 151617 31 


Figure 1-9 RX2 Format (32-Bit) 


1-10 48-050 FOO R03 


The first eight bits define the operation; the next four bits 
identify the first operand register and the next four bits 
identify the optional index register. The next bit, 16, must be 
a one. The remaining 15 bits are treated as a signed integer in 
two's complement notation. Bit 17 is the sign bit which, if one, 
indicates a negative quantity, and if zero, indicates a positive 
quantity. 


The address of the second operand is obtained in two steps. 


1. The signed integer, with sign bit extended to produce a 
32-bit integer, is added to the contents of the index 
register. 


2. This intermediate result is added to the value in the 
incremented LOC. The result is truncated to 24 bits. 


If the index register field is zero, the first addition does not 
take place. The indicated operation takes place between the 
contents of the first operand register and the contents of the 
specified memory location. The result usually replaces the 
contents of the first operand register. 


1.4.4 Register and Indexed Storage Three (RX3) Instructions 


RX3 instructions are analogous to the RX instructions in the 
16-bit processors. They call for operations between the contents 
of a register and the contents of an indexed memory location and 
require 48 bits. See Figure 1-10. 
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[or [mt [ena filifexe] se] 


BITS: 0 1112 151617181920 23 24 


Figure 1-10 RX3 Format (32-Bit) 


The first eight bits specify the operation; the next four bits 
identify the first operand register and the next four bits 
identify the optional first index register. Bit 16 must be zero. 
Bit 17 must be one. Bits 18 and 19 must be zero. The next four 
bits identify the optional second index register. The final 24 
bits contain a direct memory address. 
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The address of the second operand is obtained by adding the 
contents of the first index register to the contents of the 
second index register. This intermediate result is then added to 
the contents of the direct address field, and the final result is 
truncated to 24 bits. 


If either of the index register fields contains zero, that level 
of indexing does not take place. If both are zero, no indexing 
takes place. In most RX3 instructions, the operation takes place 
between the contents of the first operand register and the 
contents of the specified memory location. The result usually 
replaces the contents of the first operand register. 


1.4.5 Register and Immediate One (RI1) Instructions 


RI1l instructions are similar to the RI instructions in the 16-bit 
processors. They specify operations that take place between the 
contents of a register and the contents of a field that is part 
of the instruction. They require 32 bits, as shown in Figure 
1-11. 


O50=11 


[op [rifxe} 


BITS: O 78 11 12 15 16 31 


Figure 1-11 RIl1 Format (32-Bit) 


The first eight bits indicate the operation. The next four bits 
identify the first operand register and the next four bits 
identify an index register, The final 16 bits are the immediate 
value. The second operand is obtained by extending the contents 
of the immediate field to 32 bits, by propagating the sign bit 
and then adding this quantity to the contents of the index 
register. If the index register field is zero, no addition takes 
place and the extended immediate value is the second operand. 
The operation takes place between the contents of the first 
operand register and the immediate value. The result usually 
replaces the contents of the first operand register. 


1.4.6 Register and Immediate Two (RI2) Instructions 
RI2 instructions are similar to the RIl instructions except that 


the immediate field contains a 32-bit value and the instruction 
itself requires 48 bits. See Figure 1-12. 
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050-12 


ee 


BITS: 0 78 1112 15 16 47 


Figure 1-12 RI2 Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits identify 
the optional index register. The final 32 bits are the immediate 
value. The second operand is obtained by adding the contents of 
the index register to the contents of the immediate field. If 
the index register field is zero, no addition takes place and the 
immediate value is the second operand. The operation takes place 
between the contents of the first operand register and the 
immediate value. The result usually replaces the contents of the 
first operand register. 


1.4.7 Short Form (SF) Instructions 


SF instructions are similar to the SF instructions in the 16-bit 
processors. They specify operations between the contents of a 
register and the contents of an immediate field whose value is 
small enough to be expressed in four bits. These instructions 
require 16 bits, as shown in Figure 1-13. 


Figure 1-13 SF Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits are the 
immediate field. The operation then takes place between this 
value and the contents of the first operand register. The result 
usually replaces the contents of the first operand register. 
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1.4.8 Register and Indexed Storage/Register and Indexed Storage 
(RXRX) Instructions 


RXRX instructions resemble a pair of adjacent RX instructions, 
but represent one cohesive string-processing instruction. An 
RXRX instruction is comprised of two instruction members. Each 
member can be any one of the RX1, RX2 or RX3 machine formats, 
independent of the other member's format. For example, the first 
instruction member might be of the RX1l format and the _ second 
instruction member might be of the RX3 format, yielding a 10-byte 
RXRX instruction. Thus, an RXRX instruction length might range 
from 8, 10 or 12 bytes. 


The first eight bits of the first instruction member, OP, specify 
the operation class. The particular RXRX operation is specified 
by the contents of the operation-modifier (OP-MOD) field in the 
first eight bits of the second instruction member. OP-MOD is 
actually generated by the assembler according to the specific 
RXRX operation mnemonic and the R1/L1 or R2/L2 fields programmed 
by the user in source code. See Figure 1-14. 


050-14 
FIRST MEMBER SECOND MEMBER 
4TO6 BYTES 4TO6 BYTES 


31/47 0 78 11 12 


12-15 16 17 


RX1/RX2 SAMPLE MEMBER RX3 SAMPLE MEMBER 
8,10, 12 BYTES 


Figure 1-14 RXRX Format (32-Bit) 


The next four bits in the first instruction member, R1/Ll, 
identify either Rl, the string's length-specifying register or 
Ll, the string's actual length. The user specifies to the 
assembler whether the value in the R1/L1 field is a register or 
an immediate value. 
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The R1/L1 field is assumed to be a register unless an equal sign 
(=) precedes the Ll source expression. In machine format, the 
IL1 field is set when the =Ll source field specifies an immediate 
value as length. The IL2 field in machine format is reset when 
the Rl field is used to specify a register that contains the 
string's length. When the length is an immediate value, its 
value may range from 0 through 15. When the length is ina 
register, the register may contain a length that ranges from 0 
through exponent 224-1. A length of 0 indicates a null string. 


The remaining bits, 12 through 31 or 12 through 47, of the first 
instruction member, OPN1, contain the address/location of the 
lowest addressable byte of a string or its storage location. The 
field, OPN1, is then similar to the indexed address portion of an 
RX1, RX2 or RX3 machine format. 


The first eight bits of the second instruction member, OP-—MOD, 
are an operation-modifier field containing OPN1's' length 
indicator, IL1, in bit 0; OPN2's length indicator, IL2, in bit 1; 
a special circumstances bit, C, in bit 2, and in bits 3 through 
7, FUNC, the specific function code of the general operation 
class, OP. As described above, IL1 and IL2 are determined by the 
assembler. The special circumstances bit, C, and function code, 
FUNC, are determined by the assembler from the 
operation-mnemonic., The C bit is used by some RXRX instructions 
to indicate that the result of the operation will be forced 
positive. 


The next four bits, bits 8 through 11, of the second instruction 
member, R2/L2, identify either R2, this string's 
length-specifying register or L2, the string's actual length. 
Again, the user specifies in source format to the assembler 
whether the value in the R2/L2 field is a register or an 
immediate value. The R2/L2 source format field is assumed to be 
a register unless an equal sign (=) precedes the L2_ source 
expression. In machine format, IL2 is set when the =L2 field is 
used to specify an immediate value. IL2 is reset when R2 is used 
to specify a register. When the length is an immediate value, 
expressed as =L2, its value may range from 0 through 15. When 
the length is in a register, its value may range from 0 through 
exponent 274-1. A zero length indicates a null string. 


The remaining bits, 12 through 31 or 12 through 47, of the second 
instruction member, OPN2, contain the address/location of the 
lowest addressable byte of a second member's string. Both OPN1 
and OPN2 are similar in format to the indexed address portion of 
an RX1, RX2 or RX3 machine format. The particular format of 
either OPN1 or OPN2 is selectively generated by the assembler, 
independently, according to the user source program. 


In RXl1 machine format, bits 16 and 17 are zero. Bits 12 through 
15 identify the index register, X2, the contents of which are 
added to the absolute 14-bit value, D, to formulate the string's 
address. 
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In RX2 machine format, bit 16 is set. Bits 12 through > 15 
identify the index register, X2, the contents of which are added 
to the 15-bit displacement value, D2, to formulate the string's 
address. 


In RX3 machine format, bits 16 through 19 are 0100 binary. Bits 
12 through 15 identify the first index register, FX2 and bits 20 
through 23 identify the second index register, SX2. The contents 
of both are added to the 24-bit address value, A, to formulate 
the string's address, 


NOTES 


1. When the first member's OPNI1 
represents the string's address in 
RX2 format, the displacement value, 
D2, is relative to the end address of 
the first instruction member, not to 
the end of the full RXRX instruction. 


2. When the second member's OPN2 
represents the string's address in 
RX2 format, the displacement value is 
relative to the end of the second 
instruction member, which is also the 
end of the full RXRX instruction. 


1.5 VARIATIONS ON INSTRUCTION FORMATS 

Not all instructions follow the preceeding instruction formats. 
Instructions may also have the following formats: 

e Fields are redefined 

e Instructions require two operands 

e Instructions do not change the first operand 

e Instructions change the second operand 


e Instructions change neither operand 


1.5.1 Conditional Branch Instructions 


Conditional branch instructions use formats that resemble RR, RX 
and SF instructions. However, the interpretation of the fields 
differs from the standard, as does the actual operation. In all 
conditional branch instructions, the first operand identification 
is interpreted as a mask that is ANDed with the condition code. 
If the result of this test indicates that the branch is to be 
taken, then the second operand address is the location to which 
the processor must go to obtain the next instruction. 
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In the RR instructions, the second operand register contains the 
branch address. In the RX instructions, the branch address is 
obtained by one of the standard methods for obtaining second 
operand addresses, In the SF instructions, the immediate field 
is interpreted as a halfword displacement, either forward or 
backward, from the current LOC. MThe branch address is obtained 
by adding or subtracting this quantity from the current LOC, 


1.5.2 Branch and Link Instructions 


These instructions facilitate branching to and returning from 
subroutines. They use formats similar to RR and RX where the 
first operand register is the link register. Before the branch 
is taken, the address of the next memory location following the 
branch instruction is placed in this’ register. In the RR 
instructions, the branch location is the contents of the second 
operand register. In the RX instruction, the branch address is 
obtained by one of the usual methods for obtaining second operand 
addresses, 


1.5.3 Other Variations 


Some instructions change the second operand rather than the 
first. Most notable among these are the store instructions and 
the instructions that add the contents of a register to the 
contents of a memory location. 


Test instructions and compare instructions change neither 
operand. The indicated operation takes place between the two 
operands, but neither is changed. The result of the operation is 
indicated by the condition code. 


Certain other instructions, such as Load PSW and Simulate 
Interrupt, do not always require a first operand. In addition, 
all of the I/O instructions do not follow the general rules. For 
detailed information on how these instructions work, see _ the 
appropriate Processor Reference Manual. 


48-050 FOO R03 LL] 


CHAPTER 2 
SYMBOLIC REPRESENTATION 


2.1 INTRODUCTION 


When writing assembly language’ programs, the programmer’ uses 
meaningful symbols to represent the binary language interpreted 
by both Common Assembly Language/32 (CAL/32) and the processor. 
Symbols consist of printable ASCII characters, either singly or 
in combination. CAL/32 recognizes the complete set of printable 
ASCII characters, However, depending on the context, there can 
be restrictions on the use of the complete set. See Chapter 3 
for further details. 


2.2 SYMBOLS AND EXPRESSIONS 


Symbols represent addresses, register identifiers, absolute 
values, operation identifiers and constants. Examples of symbols 
are: 


REG5 
16 


Symbols can be combined to form expressions. The arithmetic 
operators: add, subtract, multiply and divide are represented in 
CAL/32 by the symbols: +, -, * and /. They combine with other 
symbols to form arithmetic expressions. Examples of these 
arithmetic expressions are: 


A+B 
LAST-FIRST*TWO 
A-16 


Blanks and parentheses are not permitted within an expression. 
For example, the following sequence would not be interpreted by 
CAL/32 as an expression. 


A- B* (C + D) 
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Depending on the context, CAL/32 might misinterpret the symbols, 
generate incorrect code and fail to detect the error. Where 
CAL/32 can recognize the error, it generates an error message. 


The evaluation of expressions takes place from left to right with 
no rules of precedence. Thus, CAL/32 evaluates the expression: 


LAST-FIRST*TWO 


by subtracting the value of FIRST from the value of LAST, and 
multiplying this result by the value of Two. 


Logical expressions consist of symbols joined by the logical 
operators AND and inclusive OR. They are represented in CAL/32 
by the symbols & and !. Examples of logical expressions are: 


X&YIA 
CHAR&NULL 


Logical expressions are evaluated from left to right with no 
rules of precedence. Blanks and parentheses are not permitted in 
logical expressions. 


Mixed expressions are formed by combining logical and arithmetic 
Operators. For example: 


A-B!TWO 


CAL/32 evaluates this expression by first subtracting the value 
of B from the value of A and then ORing the result with the value 
of TWO. Mixed expressions are like arithmetic and logical 
expressions in that blanks and parentheses are not allowed and 
the method of evaluation is from left to right with no rules of 
precedence. 


Symbols represent either absolute or relocatable quantities. At 
assembly time, relocatable quantities have a value equal to their 
displacement from some fixed point within the program, usually 
but not necessarily, the origin or starting location. At load 
time, the relocatable quantity is replaced by an absolute 
quantity whose value is calculated by adding the relocation value 
to the relocatable quantity. Absolute quantities are known to 
the assembler at assembly time and are not changed at load time. 


The operations: multiply, divide, AND and OR are permitted only 


between absolute data. The plus and minus operators can be used 
On mixed data. The results of such operations are: 
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OPERATION RESULT 


Absolute + Absolute Absolute 
Absolute - Absolute Absolute 
Relocatable + Relocatable Invalid 
Relocatable - Relocatable Absolute 
Relocatable + Absolute Relocatable 
Relocatable - Absolute Relocatable 
Absolute + Relocatable Relocatable 
Absolute - Relocatable Invalid 


2.3 SYMBOLS AND THEIR VALUES 


By definition, certain symbols used in CAL/32 programming have 
implicit values; that is, the value of the symbol is determined 
by the way in which it is expressed and used. Examples of this 
kind of symbol are the decimal, hexadecimal and character symbols 
used as operands in instructions, There are also global symbols 
in CAL/32. These symbols have preset values that cannot be 
redefined by the programmer. The programmer can define the value 
of a symbol explicitly by using the equate statement. This 
section covers the use of implicit and global symbols. Chapter 
3 covers the explicit use and definition of symbols. 


2.3-1 Implicit Symbols 


When used in the correct context, a string of decimal digits is 
automatically assigned the actual value of the number represented 
by the string. For example, the expression: 


A+14 


has a value that the assembler determines by adding the quantity 
14 to the value A, which must be defined by some other means. 


CAL/32 also recognizes the implicit value of special character 
strings the programmer uses to represent decimal, hexadecimal and 
character values. These strings are made up of a single letter 
that indicates the particular type, followed by a group of 
characters enclosed in apostrophes that represents the value, 
The code characters are: 


CODE 
CHARACTER TYPE 
H Halfword decimal 
F Fullword decimal 
Xx Halfword hexadecimal 
Y Fullword hexadecimal 
C Character 
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Decimal numbers consist of an optional sign (+ or -) followed by 
decimal digits representing the actual value. Commas are not 
allowed in the representation. Halfword decimal values can be 
represented by one to five decimal digits, with a range from 
-32,768 to +32,767. Fullword values can be represented by one to 
ten decimal digits, with a range from -~2,147,483 ,648 to 
+2,147,483,647. CAL/32 converts these decimal numbers into two's 
complement binary integers. Examples of decimal symbols, with 
their internal representation expressed in hexadecimal notation, 
are: 


SYMBOL VALUE 
H'125' 007D 
H'32765' 7FFD 
H'+32765' 7FED 
H'-15!' FFF1 
F'123123' 0001 EOF3 
Ffjy! 0000 0001 
BeeZ FFFF FFFE 


Hexadecimal symbols consist of the X or Y type code followed by 
a string of hexadecimal digits enclosed in apostrophes. Halfword 
symbols can use from one to four digits. Fullword symbols can 
use from one to eight digits. Leading zeros are not required and 
the value is right justified. Examples of hexadecimal symbols 
are: 


SYMBOL VALUE 


X'F! OOOF 
X'D4E' OD4E 
Y'030' 0000 0030 
Y'aA' 0000 000A 
v0" 0000 0000 


Character symbols consist of one to four ASCII characters 
enclosed in apostrophes and preceded by the type code C. 
Characters are right justified, with zero fill. Depending on the 
context, either a halfword or a fullword results. Examples of 
character symbols are: 


SYMBOL VALUE VALUE 
(HALFWORD) (FULLWORD ) 
Cor 002A 0000 002A 
Cri2' 3132 0000 3132 
C'AB' 4142 0000 4142 
C'1234' 3334 3132 3334 
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In the last example, where a halfword value was generated, only 
the right-most two characters were used. Where the context 
dictates a halfword and a longer string is used, a_ truncation 
error results. One final type of implicit assignment occurs in 
the use of symbols as statement identifiers. Where a symbol is 
used in the name field of a statement, it is automatically 
assigned a value equal to the value of the current location 
counter (LOC). This type of assignment is covered in Chapter 4. 


2.3.2 Global Symbols 


Six symbols recognized by CAL/32 have predetermined values. They 
ares 


ADC 
LADC 
PURETOP 
IMPTOP 
ABSTOP 
* 


The use of these symbols is somewhat restricted and they cannot 
be redefined by the programmer. 


In programs written for 32-bit processors, the address length 
constant (ADC) always has a value of 4, the length of an address 
constant in bytes. (In 32-bit processors, addresses must _ be 
contained in fullwords, even though the actual address is only 24 
bits in length.) In programs for which CAL/32 is to generate 
16-bit code, the ADC has the value of 2. In programs written for 
32-bit processors, the log (base 2) of the address’ length 
constant (LADC) always has a value of 2. In programs for 16-bit 
processors, the LADC always has a value of 1. Both of these 
symbols, the ADC and the LADC, are used most frequently in common 
mode programming. See Chapter 4. 


The symbols PURETOP, IMPTOP, and ABSTOP have values equal to: 


PURETOP The next available location in the pure segment 
IMPTOP The next available location in the impure segment 
ABSTOP The next available location in the absolute segment 


Because these values change during assembly, the symbols must be 
used carefully. They can be used as second operand identifiers 
in machine instructions and as operands in assembler instructions 
where they are treated as address values. They cannot be used in 
assembler instructions that control the LOC. 
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The asterisk symbol (*), used as an operand rather than an 
operator in an expression, always has a value equal to the value 
of the current LOC, Throughout the assembly process, CAL/32 
Maintains a LOC analogous to the hardware LOC contained in the 
central processing unit (CPU). Depending on the organization of 
the program, this LOC can contain any one of several values. For 
32-bit programs, the LOC may point to the current location in the 
absolute segment, the pure segment or the impure segment. For 
16-bit assemblies, the LOC may point to the current absolute 
location or the current relocatable location. 


NOTE 


While processing within block data 
programs, common block definitions or 
structure definitions, LOC has an 
absolute nonrelocatable value. This 
value is equivalent to the offset from 
the beginning of the block, common or 
structure definition to the current 
location. 
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CHAPTER 3 
THE SOURCE PROGRAM 


3.1 INTRODUCTION 


The source program consists of a set of assembly language 
statements that perform the following functions: 


e Specify the operations to be performed by the processor 
@e Define the constants and storage areas for the program 


e Control the assembly process to produce the desired output 


Source statements for Common Assembly Language/32 (CAL/32) are of 
two types: comment statements and instruction statements. 
Comment statements provide documentation of assembly 
instructions. This aids in the readibility of the program, which 
is essential when debugging or enhancing the source code. 
Instruction statements are divided into machine instructions and 
assembler instructions. Each statement consists of an 
80-character record, in which symbols and expressions identify 
the statement, and where necessary, indicate the operation and 
locate the operands. 


3.2 COMMENT STATEMENTS 


Comment statements can appear anywhere in the source program. 
They allow the programmer to include easy-to-read documentation 
in the source program listing. They produce no object code. The 
assembler does not process comment statements except to check for 
proper sequencing and scan for invalid characters. 


Comment statements must always start with an asterisk (*) in the 
first character position. Positions 2 through 71 can contain any 
printable ASCII character, including lower-case alphabetic 
characters. Blanks are considered to be "printable" characters. 
If a nonprintable character turns up in a comment statement, 
CAL/32 replaces it with a pound sign (#). Figure 3-1 illustrates 
comment statement syntax. 
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050-16 


*THIS IS A COMMENT STATEMENT 
*IT IS DENOTED BY THE ASTERISK (*) IN COLUMN 1 
*IT MAY APPEAR ANYWHERE WITHIN THE SOURCE PROGRAM 


Figure 3-1 Comment Statement Column Positioning 


Positions 72 through 80 are ignored by CAL/32; however, positions 
73 through 80 can, at the programmer's option, be used for 
sequence identification. The sequence field can contain any 
printable ASCII character other than lower-case alphabetic 
characters. Where sequence checking is requested, each 
Successive sequence identifier must be greater, in the ASCII 
collating sequence, than the previous identifier. Figure 3-2 
illustrates the use of sequence identification within a user 
created source program. 


050-17 


GET00001 
GET00002 
GETO0008 


Figure 3-2 Source Program Sequence Identification 


3.3 INSTRUCTION STATEMENTS 

Instruction statements can be written in fixed format or in free 
format. For either format, there are five distinct fields in 
each statement and limitations on the length of certain fields. 
The five fields are as follows: 

@e Name field 

@e Operation field 

e Operand field 


e Comment field 


@e Sequence field 


3.3.1 Fixed Format Source Programming 


Fixed format requires that the instruction and comment statements 
be positioned within specific columns when coding a CAL/32 
program. 
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CHARACTER POSITIONS DEFINITION 


1 through 8 | Name field 

10 through 14 Operation field 
16 through n Operand field 
n+2 through 71 Comment field 


73. through 80 Sequence field 


Positions 9 and 15 must always contain blank characters. The 
operand field and the comment field are variable in length, and 
the first blank character after position 16 serves as a delimiter 
between the operand field and the comment field. Because of the 
way the output listing is tabulated, the comment field cannot 
contain more than 37 characters. If more than 37 characters 
appear, only the first 37 are printed on the output listing. 
Figure 3-3 illustrates instruction statement positioning using 
the fixed format method. 


Figure 3-3 Instruction Statement Positioning (Fixed Format) 


3.3.2 Free Format Source Programming 


CAL/32 does not require source statements to be written in fixed 
format. It accepts free format source programs, in which blank 
characters serve as delimiters. If, for example, the name field 
is not used, a blank character in the first position indicates 
that the next nonblank character is the start of the operation 
field. Similarly, if the operation field requires fewer than 
five characters, the first blank character following the 
operation code indicates that the next nonblank character is the 
first character of the operand field. As in the fixed format 
statement, the first blank character following the operand field 
indicates the end of that field and the beginning of the comment 
field. There are two restrictions on the use of free format: 


1. Comment length is limited to 37 characters, including blanks. 


2. The sequence field must start in position 73. 
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The second restriction is because CAL/32 cannot distinguish 
between a blank character as part of a comment and a blank 
character intended to separate the comment from the sequence 
field. 


If there are no nonblank characters in positions 1 through 20, 
CAL/32 assumes that the statement is a comment and lists it as 
such with a warning note. If more than 15 blanks separate the 
name field from the operation field, CAL/32 assumes that the 
operation field is not present. Similarly, if more than 15 
blanks separate the operation field from the operand field, 
CAL/32 assumes that the operand field is not present. In both 
cases, CAL/32 generates an error message. 


3.4 COMMON ASSEMBLY LANGUAGE (CAL/32) INSTRUCTION REPRESENTATION 


When writing CAL/32 instruction statements, the programmer’ uses 
symbolic representation in the name field, the operation field 
and the operand field. The following sections describe the use 
of symbols and expressions in these fields. 


3.4.1 Name Field 


Where a symbol appears in the name field, it represents the value 
of the current location counter (LOC) for that particular 
instruction. This allows the programmer to refer to specific 
locations symbolically, without having to know the actual value 
of the LOC. The following five restrictions apply to the 
formation of names: 


1. The first character of a name must be an upper-case or 
lower-case alphabetic character or one of the following 
special characters: 

@ commercial at sign (@) 
@e dot (.) 
@e dollar sign (S$) 
@e underscore (_) 
NOTE 
Lower-case letters are converted 
internally to upper-case except in string 


constants and when the NLCASE directive 
is in effect. 
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2. The remaining characters can be made up of any combination of 
valid first characters, plus the numeric characters 0 through 
9. 


3. The name must consist of one to eight characters. 


4. The name must start in the first character position of the 
source record, 


5. Embedded blanks are not permitted. 


Examples of valid names are: 


LABEL 
LOOP1 
- SIN 

@GOTO 
SSGET5 


Examples of incorrect names are: 


1 LOOP First character is numeric 
LOOPCOUNTER More than eight characters 
AB ?C Question mark is illegal 


As a general rule, a given symbolic string can appear only once 
in the program where it defines a location. That is, the same 
symbol may not appear in the name field of more than one 
instruction. The exception to this is the Equate instruction. 
This is covered in the section on assembler instructions. 


3.4.2 Operation Field 


The use of symbols in the operation field is severely restricted. 
Only previously defined symbols can appear in this field. The 
symbols that appear in the operation field are called mnemonics; 
they represent operations to be performed by the processor at 
run-time, or operations to be performed by the assembler. CAL/32 
recognizes mnemonics that represent all machine operations for 
all processors, It also recognizes a large set of assembler 
mnemonics that allows the programmer to control the assembly 
process. 


Mnemonics can consist of no more than five characters. They are 
formed in the same way as names and use the same character set. 
CAL/32 permits users to define mnemonics. This process is 
described in the section that deals with the Equate instruction. 
Specific mnemonics that define machine operations and assembler 
operations are described later in this chapter. Examples of 
operation mnemonics are: 
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MNEMONIC TYPE MEANING 


AR Machine Add register 

S Machine Subtract 

CLI Machine Compare logical immediate 
ORG Assembler Set location counter 


3.4.3 Operand Field 


CAL/32 permits the use of both symbols and expressions in the 
operand field of instructions. Symbols used in the operand field 
can be implicitly defined or can be explicitly defined. The 
rules for forming operands for assembler instructions vary from 
instruction to instruction, and each is described individually 
later in this chapter. 


Most machine instructions require two operands while some require 
only one. Where two operands are required, the first is 
separated from the second by a comma, Following are the general 
rules for forming operands for machine instructions. 


3.4.3.1 Register-to-Register (RR) Instructions 


Both the first and the second operand must be represented by 
symbols or expressions with values between 0 and 15 inclusive. 
If the value is greater than 15 or less than 0, the assembler 
sets it to 0 and generates an error message. For example, if the 
symbols 1 and 2 appear in the operand field of the Add Register 
instruction: 


AR 1,2 


CAL/32 generates the machine code to add the contents of register 
2 to the contents of register 1 and store the result in register 
1s The use of 1 and 2 here is an example of how decimal numbers 
have an implicit value when used in the proper context. Another 
example: 


AR X'1',xX'2' 


shows how hexadecimal symbols can be used as register 
identifiers. This is an exception to the previously stated rule 
that hexadecimal symbols generate halfword or fullword values. 
Where used as register identifiers, decimal, hexadecimal and 
character symbols cause the assembler to generate 4-bit values. 


Expressions can be used in identifying registers, as in: 


AR A+B,C'A'-X'40' 
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where CAL/32 evaluates the expressions and uses the results as 
the register identifiers. This is not a universally useful 
feature of the language, although it has some applications in 
common mode programming. 

A more useful way to identify registers is to use explicitly 


defined symbols. Suppose the symbols SUM and INC are defined to 
have values of 1 and 2, respectively. Then the instruction: 


AR SUM, INC 
has the same effect as: 
AR see 


3.4.3.2 Register and Indexed Storage (RX) Instructions 

If the first operand is required, it must be a valid register 
identifier as described for RR instructions. The second operand, 
separated from the first by a comma, can be 

@e a symbol, 

® an expression, or 

@ aosymbol or an expression followed by an index register 


identifier enclosed in parentheses, 


Where indexing is used, identification of the registers follows 
the same rules as those for specifying first or second operand 
registers. In double-indexed instructions, the first and second 
index identifiers are separated by a comma. An example of how 
(RX) instructions are written is: 


S 1,A 


where the first operand is the contents of general register l, 
and the second operand is the value at location A in memory. 
Another example: 


S SUM, TABLE (PTR) 
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shows how single indexing is expressed. In this case, the first 
operand is the value contained in the register identified by the 
symbol SUM, and the second operand is the value at memory 
location table plus the contents of the index register PTR. 
Another example: 


S SUM, LAST-FIRST (BASE, PTR) 


shows the use of double indexing along with the use of an 
expression in the operand field. A final example: 


FS) SUM, 0 (ADDR) 


illustrates where an address of a second operand is contained in 

the index register. Here, there must be a symbol in the address 

field even if it is equal to zero... | 

3.4.3.3 Register and Immediate (RI) Instructions 

The first operand must be specified by a valid register 

identifier. The second operand can be 

e a symbol, 

@ an expression, or 

@ aosymbol or an expression followed by an index register 
identifier enclosed in parentheses, 

Example: 


CLI STRNG,C'ABCD' 


causes the character string ABCD, represented internally as_ the 
fullword character value 4142 4344, to be compared with the 
contents of the register identified by the symbol STRNG. In 
another example: 


CLI ADDR, LAST-FIRST (PTR) 


the expression LAST-FIRST is evaluated by CAL/32 at assembly 
time. At run-time this value is added to the contents of the 
index register before the comparison takes place. In another 
example: 
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CLI ADDR, Y'2000' (PTR) 


the fullword, hexadecimal quantity 0000 2000, 


contents of the index register. 


the contents of the register identified by the 


3.4.3.4 Register and Indexed Storage/Register 


is added to the 
then compared with 
symbol ADDR. 


The result is 


and Indexed 


Storage (RXRX) Instructions 


The RXRX instructions have four basic source operand fields, each 


of which is separated from the 
operand field can be 


@e avalid register identifier, 
defined absolute value in the 

@ an equal sign (=) preceding a 
defined absolute value in the 


The second source operand field, 


other by a comma. The first 
Symbol, or expression with a 
range 0 to 15; or 


symbol or an expression with a 
range 0 to 15. 


separated from the first by a 


comma, can be 

@ a symbol or an expression; 

@® a symbol or an expression, optionally followed by an index 
register identifier enclosed in parentheses; or 

@® a symbol or an expression, optionally followed by a pair of 
index register identifiers, separated by a comma, with the 


pair enclosed in parentheses. 


The third source operand field, separated from the 


comma, can be 


e avalid register identifier, 
defined absolute value in the 

@e an equal sign (=) preceding a 
defined absolute value in the 


The fourth source operand field, 
comma, can be 


@® a symbol or an expression; 


second by a 


symbol, or expression with a 
range 0 to 15; or 


symbol or an expression with a 
range 0 to 15. 


separated from the third by a 


@ a symbol or an expression, optionally followed by an index 
register identifier enclosed in parentheses; or 
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@ a symbol or an expression, optionally followed by a pair of 
index register identifiers, separated by a comma, with the 
pair enclosed in parentheses, 


Examples of how these instructions are written are: 
MOVE =LENGTH2,HERE,=LENGTH1, THERE 


which moves the string of length, LENGTH1, at location THERE to 
the location HERE up to the number of bytes indicated by LENGTH2. 
Tf LENGTH] is less than LENGTH2, this instruction pads the extra 
bytes with the right-justified character in general register 
Zero. 


In the preceding example, the first operand field is the 
immediate value of symbol LENGTH2. The equal sign that specifies 
LENGTH2's value is an immediate value and not ae register 
identifier. The second operand field is the storage address at 
location HERE. The third operand field is the immediate value of 
symbol LENGTH] (its immediacy is again indicated by the equal 
sign). The fourth operand field is the string at location THERE, 
Another example is: 


MOVEP R7,PRINTOUT(LINE, COL2) ,R8,MESSAGE (CLASSX, ERRINDX) 


which moves the string of the length specified in general 
register R8, found at the memory location computed by summing the 
address value of MESSAGE with the contents of both index 
registers CLASSX and ERRINDX. The string is moved to a_ storage 
location whose address value is computed by summing the address 
value of PRINTOUT plus the contents of both index registers, LINE 
and COL2. The number of bytes to be filled is the length 
specified in general register R7. If the length in R8 is less 
than that in R7, the MOVEP instruction, by definition, pads_ the 
extra bytes with the default character, a space. 


In the preceding example, the first operand field is the register 
identifier, R7; the second operand field is the storage address 
at location PRINTOUT, as double indexed by the register 
identifiers, LINE and COL2; the third operand field is the 
register identifier, R8; and the fourth operand field is the 
string's location MESSAGE, as double indexed by the register 
identifiers, CLASSX and ERRINDX. Another example is: 


PMV =8, DECSUMS (SALESID) ,5, TOTALS (ORDERX) 


which packs and moves the unpacked decimal data digit string 
whose length is indicated in general register 5. Note that the 
5 means a general register because no equal sign precedes it. 
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The unpacked decimal data digit string is found at the memory 
location computed by summing the address value of TOTALS with the 
contents of the single index register identifier ORDERX. For 
details on how this conversion takes place, refer to _ the 
instruction definitions in ‘the appropriate processor manuals. 
Generally, the unpacked decimal data is converted to packed 
decimal data up to the number of digits that may occupy the 
reserved byte length, indicated by the =8 expression. In this 
case, eight bytes are reserved, providing storage for 15 decimal 
packed digits and a position for the sign-indicator. The PMV 
instruction, by definition, has various safeguards for illegal 
digit cases and overflow, and provides leading zeros as _ needed, 
when the number of positions available for either the unpacked 
digits and the packed digits is of unequal length. The memory 
location to which the converted digit data is moved is computed 
by summing the address value of DECSUMS with the contents of the 
Single index register SALESID. 


In the preceding example, the first operand field is the 
immediate value =8. Note that the equal sign specifies that 8 is 
an immediate value and not a register identifier. The second 
operand field is the address location DECSUMS as singly indexed 
by the register identifier, SALESID. The third operand field is 
the register identifier 5; and the fourth operand field is the 
address location TOTALS, as indexed by the single index register 
identifier ORDERX. 


3.5 COMMON ASSEMBLY LANGUAGE/32 (CAL/32) MACHINE INSTRUCTIONS 
Table 3-1 lists the mnemonics for CAL/32 machine instructions. 
Where there is no entry in the format column, that instruction is 
not available for that particular line of processors. 
NOTE 
Some machine instructions are illegal on 
the auxiliary processing unit (APU) in 


the 3200MPS Family of Processors and are 
so noted in Table 3-1. 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 


AND MNEMONICS 


Sem ents ee ere See ee a ee ee ee ew ee ee ae eee See Oe EL ee eee ee Ge ee ee ee ee ee em OO ee OO Ge OE en OF Eee ee OS OP Oe Oe Gre ee 


32-BIT 
FORMAT 


| 16-BIT | 
| FORMAT | 


es eae RD oe SS eee ES ME ED GE ES SE Ee GES GT Mes GOR Ge Gh Ge ee ae eee SOE mee Oe Gee Gee See eee Se OE Oe ere Ger Ee OE Cee Om ee Om om aes oe Oe ee oe oe Oe Oe 
Se ase oe one San San So Gan Son Se GSS SRS Ge Gas St Gas Gwe GES GAS Ge See Ge See OOS Gee Se Se See Ses ee GE SS GN Ged Gas Ene Gem. Em five Gas GS Gee Eee SEF Ses See See See OE Se SE CHS Ee GS Gwe aoe Gee 


Add 

Add DP floating point 
Add DP floating point 
register 

Add to bottom of list 
Add to bottom of list 
flagged 


Add with carry halfword 
Add with carry halfword 
register 

Acknowledge interrupt 
Acknowledge interrupt 
register 

Add floating point 

Add floating point 
register 

Add halfword 

Add halfword immediate 
Add halfword to memory 
Add halfword register 
Acknowledge interrupt 
Add immediate 
Acknowledge interrupt 
register 

Add immediate short 
Autoload 


Add to memory 

Add register 

Add to top of list 

Add to top of list flagged 
Branch and link 

Branch and link register 
Branch to control storage 
Branch on equal status 
high speed 


Branch on false condition 
backward short 


SF 


ys) 
9] 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| 
INSTRUCTION | MNEMONIC 


48-050 FOO RO3 


32-BIT 
FORMAT 


RX 
RR 


SF 


SF 


| FORMAT 


16-BI 


RX 
RR 
SF 


RX** 


| 

| 

| Branch on false condition | BFC 
| Branch on false condition | 

| register | BFCR 
| Branch on false condition | 

| forward short | BFFS 
| Branch on not equal status | 

| high speed | BNSHS 
| Branch on true condition | 

| backward short | BTBS 
| 

| Branch on true condition | BTC 
| Branch on true condition | 

| register | BTCR 
| Branch on true condition | 

| forward short | BTFS 
| Branch on index high | BXH 
| Branch on index low or | 

| equal | BXLE 
| Compare | iC 

| Complement bit | CBT 
| Compare DP floating point | CD 

| Compare DP floating point | 

{| register {| CDR 
| Compare floating point | CE 

| Compare floating point | 

| register | CER 
| Compare halfword | CH 

| Compare halfword immediate | CHI 
| Compare halfword register | CHR 
| Convert to halfword value | 

| register | CHVR 
| Compare immediate | CI 

| Compare logical | CL 

| Compare logical byte | CLB 
| Compare logical halfword | CLH 
| Compare logical halfword | 

| immediate | CLHI 
| 

| Compare logical halfword | 

| register | CLHR 


ee ce ree me ere cee ee cere eee ee ce es ee cers ee Cm rm re eee Cm ee mms ces ome mes ce cm cm ce re ces ce ee ees res ee ee ee ee ee eee 


TABLE 


3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


oe ae are SS ae OP oe Gee Oe Gee GE 8 mee ee ee EE Gm a es Ow Gee me OR OE Os ee Ore a ee ee er ee ee eee ee es Oe Oe re Om OS ee Om ee OD Gee Oe 


IN 


STRUCTION 


MNEMONIC 


32-BIT 
FORMAT 


| 16-BIT | 
| FORMAT | 


a me a rl ee Bn od 
ee ss ~Y fs ee es 


Compare 1] 
Compare 1] 
Compare r 
Cyclic re 
modulo 12 


Cyclic re 
modulo 16 
Decrement 
speed 
Divide 
Divide DP 
Divide DP 
register 


Divide fl 
Divide fl 
register 
Divide ha 
Divide ha 
Divide re 
Enter con 
Exchange 
register 
Exchange 
Exchange 
Float DP 
Float reg 
Fix DP re 
Fix regis 
Generate 
interrupt 
Load 

Load addr 
Load byte 


Load byte 
Load byte 
indirect 
Load byte 


ogical immediate 
ogical register 
egister 

dundancy check 


dundancy check 


counter high 


floating point 
floating point 


oating point 
oating point 


lfword 

lfword register 
gister 

trol storage 
program status 


byte register 
halfword register 
register 

ister 

gister 

ter 

inter process 


ess 
high speed 


high speed 


register 


RR 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | 32-BIT | 16-BIT 

| INSTRUCTION | MNEMONIC | FORMAT | FORMAT 

| Load complement short | Lcs | SF | SF 

| Load DP floating point | LD | RX | RX 

| Load DP floating point | | | 

| register | LDR | RR | RR 

| Load floating point | LE | RX | RX 

| Load floating point | | | 

| register | LER | RR | RR 
| | 

| Load halfword | LH | RX | RX 

| Load halfword immediate | LHI | RIl | RI 

| Load halfword logical | LHL | RX | RxX* 

| Load halfword register | LHR | RR* | RR 

| 

| Load immediate | LI | RI2 | RI* 

| Load immediate short | LIs | SF | SF 

| Load multiple | LM | RX | RX 

| Load multiple DP floating | | | 

| point | LMD | RX | RX 

| Load multiple floating | | | 

| point | LME | RX | RX 

| Load program status | LPs | | RX 

| Load program status | | | 

| register | LPSR | | RR 

| Load program status word | LPSW | RX | RX 

| Load program status word | LPSWR | RR | 

| register | | | 

| Load real address | LRA | RX | 

| Load register | LR | RR | RR* 

| Load unnormalized floating | LU |} RX+ | 

| point | | 

| Load unnormalized floating | | | 

| point register | LUR | RR+ | 

| Load unnormalized DP | | | 

| floating point | LW | RX+ | 

| Load unnormalized DP | | | 

| floating point register | LWR | RR+t+ | 

| Multiply | M | RX | RX* 

| Multiply DP floating point | MD | RX | RX 

| Multiply DP floating point | | | 

| register | MDR | RR | RR 

| Multiply floating point |] ME | RX | RX 

| Multiply floating point | | | 

| register | MER | RR | RR 

| Multiply halfword | MH | RX | RX 

| Multiply halfword register | MHR | RR* | RR 

| Multiply halfword unsigned | MHU | | RX 

| Multiply halfword unsigned | | | 

| register | MHUR | | RR 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 
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| | 32-BIT | 16-BIT | 
INSTRUCTION | MNEMONIC | FORMAT | FORMAT | 


Move and process byte 


| 

| 

| | 
| | | | | 
| string register | MPBSR | RRs | | 
| Multiply register | MR | RR | RR* | 
| AND | N | RX | Rx* | 
| AND halfword | NH | RX | RX | 
| AND halfword immediate | NHI | RIl | RI | 
| | 
| AND immediate | NI | RI2 | RI* | 
| AND halfword register | NHR | RR* | RR | 
| AND register | NR | RR | RR* | 
| OR | Oo | RX | Rx* | 
| Output command | Oc | RX | RX | 
| 

| Output command register {| OCR | RR | RR 
| OR halfword | OH | RX | RX | 
| OR halfword immediate | OHI | RIl | RI | 
| OR halfword to memory | OHM | | Rx** | 
| OR halfword register | OHR | RR* | RR | 
| OR immediate |} OF | RI2 | RI* | 
| OR register | OR | RR | RR* | 
| Process byte | PB | RX% | | 
| Process byte register | PBR | RR | | 
| Read block | RB |} RX%% | RX | 
| Remove from bottom of list | RBL | RX | RX | 
| Remove from bottom of list | | | | 
| flagged | RBLF | | RX** | 
| Read block register | RBR | RR&S | RR | 
| Reset bit | RBT | RX | | 
| Read data |} RD | RX | RX | 
| Read DCS | RDCS | RR | RR { 
| Read data high speed | RDHS | | RxX*¥* | 
| Read data high speed | | | | 
| register | RDRHS | | RR** | 
| Read data register | RDR | RR | RR | 
| Read halfword | RH |} RX | RX | 
| Read halfword register | RHR | RR | RR | 
| | | | | 
| Rotate left logical | RBLL | RIl | RI | 
| Rotate left logical short | RLLS | | SE** | 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | 32-BIT | 16—-BIT | 
INSTRUCTION - | MNEMONIC | FORMAT | FORMAT 


ee ee ee ee ee es Fe ee Oe ee OE BE Ge: OT re ee ee OES Cee See Ge Ge em Oe Oe Gee Gee Gee ee Oe Ore UE Os Ces EE Ore Oe OD Gee Oe Oe Ore Oe Oe Ger ey OE Oe ee Om ae ee 
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Read process data high 


| 
| 
| | 
| | | | | 
| speed | RPDHS | | RX** | 
| Replace PSW | RPSW | | RR** | 
| | 
| Rotate right logical | RRL | RIl | RI | 
| Rotate right logical short | RRLS | | SE** | 
| Remove from top of list | RIL | RX } RX | 
| Remove from top of list | | | | 
| flagged | RTLF | | Rx** | 
| Subtract | §s | RX | Rx* | 
| | | 
| Store byte high speed | | | | 
| indirect | SBHSTI | | RI*¥* | 
| Set bit | SBT | RX | | 
| Subtract with carry | | | | 
| halfword | SCH | | RX | 
| Subtract with carry | | | | 
| halfword register | SCHR | | RR | 
| Simulate channel program | SCP | RX% | | 
| | | | | 
| Subtract DP floating point | SD | RX | RX | 
| Subtract DP floating point | | | | 
| register | SDR | RR |] RR | 
| Subtract floating point | SE | RX | RX | 
| Subtract floating point | | | | 
| register | SER | RR | RR | 
| Set program mask | SETM | | RX | 
| Set program mask register | SETMR | | RR | 
| Subtract halfword | SH | RX | RX. | 
| Subtract halfword immediate| SHI } RIl | RI | 
| Subtract halfword from | | | | 
| memory | SHM | | RxX** | 
| Subtract halfword register | SHR | RR* | RR | 
| Subtract immediate | SI | RI2 | RI* | 
|} Simulate interrupt | SINT | RIl | RI | 
| Subtract immediate short | SIs | SF | SF | 
| | | 
| Shift left arithmetic | SLA | RI | RI | 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 

. | 32-BIT | 16-BIT | 
INSTRUCTION | MNEMONIC | FORMAT | FORMAT | 
+f $4 —F —f +t te 2 oe 2 Ee 2 2 2 2 a 2 a 2 2 2 2 2 2 2 | 
Shift left halfword | | | | 
arithmetic | SLHA {| RIl | RI | 
Shift left halfword | | | ‘| 
logical | SLHL | RIl | RI | 
Shift left logical | SLL | RIl | RI | 
Shift left halfword | | | | 
logical short | SLHLS | SF | RI | 
Shift left logical short | SLLS | SF | SF 
Store PSW | SPSW | | RR** | 
| | | 
Subtract register | SR | RR | RR* | 
Shift right arithmetic | SRA | RIl | RI | 
Shift right halfword | | | | 
arithmetic | SRHA | RIl | RI 
Shift right halfword | | | | 
logical | SRHL | RI | RI | 
Shift right logical | SRL |} RI | RI | 
| | | | 
Shift right halfword | | | | 
logical short | SRHLS | SF | SF | 
Shift right logical short | SRLS | SF | SF | 
Sense status |} ss | RX | RX | 
Sense status register | SSR | RR | RR | 
Store | St | RX | RxX* | 
| | 
Store byte | STB | RX | RX | 
Store byte high speed {| STBHS | | RxX** | 
Store byte register | STBR | RR | RR | 
Store DP floating point | STD | RX | RX | 
Store floating point | STE | RX | RX | 
: | | | 
Store halfword | STH | RX | RX | 
Store multiple | STM | RX | RX | 
Store multiple DP floating | | | | 
point | STMD | RX | RX | 
Store multiple floating | | | | 
point | STME |} RX | RX | 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 

| | 32-BIT | 16-BIT 
| INSTRUCTION | MNEMONIC | FORMAT | FORMA 
| a a ma EE a 
| Supervisor call | svc | RX | RX 
| Test bit | TBI | RX | 
| Test halfword immediate | THI | RI | RI 
| Test immediate | I | RI2 | RI* 
| Translate | MTLATE | RX | Rx** 
| Test and set | TS | RX | 
| Unchain | UNC | | RR** 
| Write block | WB | RX%% | RX 
| Write block register | WBR | RRS | RR 
| Write data | WD | RX |} RX 
| Write DCS | WDCS | RR | RR 
| | | | 
| Write data register | WDR | RR | RR 
| Write data high speed | WDHS | | Rx** 
| Write data high speed | | | 
| register | WDRHS | | RR** 
| Write halfword | WH | RX | RX 
| Write halfword register | WHR | RR | RR 
| Write processed data high | | | 
| speed | WPDHS | | Rx** 
| Exclusive OR | xX | RX | RxX* 
| Exclusive OR halfword | XH | RX | RX 
| Exclusive OR halfword | | | 
| immediate | XHI | RIl | RI 
| Exclusive OR halfword | | | 
| register | XHR | RR* | RR 
| | | | 
| Exclusive OR to memory | XHM | | RxX** 
| Exclusive OR immediate | XI | RI2 | RI* 
| Exclusive OR register | XR | RR | RR* 

* The indicated mnemonic operation code is generated, 


and the listing is flagged with 
indicate a potential error. 


Model 50 instruction set. 


% These instructions are illegal 
3200MPS Family of Processors 


%% 
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on the APU 


a question mark to 


of 


Not applicable for 3200MPS Family of Processors, 


the 


+ The indicated instruction pertains to the Model 3203 and 
3205 Processors, and 3280 Systems only. When any of these 
instructions is encountered during assembly, a pound sign 
(#) is placed in the first column of the listing. A 
Single DCMD is placed in the object code. The text of the 
DCMD is: 


**k*k*XMODULE xxxx CONTAINS NON-NORMALIZING LOADS 
Where: 
XXXX is the name of the module. 


The no processor specific warning (NPWRN) instruction can be used 
to suppress the warning and the DCMD output that is generated for 
these instructions. 


There are three machine instructions for the APU of the 3200MPS 
Family of Processors. They are summarized in Table 3-2. See the 
appropriate instruction set reference manual for an explanation 
of these new machine instructions. 


TABLE 3-2 CAL/32 MACHINE INSTRUCTIONS AND MNEMONICS 
FOR THE 3200MPS FAMILY OF PROCESSORS 


| | | 32-BIT | 
| INSTRUCTION | MNEMONIC | FORMAT | 
"Generate Signal’ | ase || 
! Read real-time counter | RRTC | RR | 
| Reschedule | RSCH* | SF | 


* This instruction is not supported by the IOP 
for the 3230MPS or 3260MPS. 


OS/32 RO8.2 and higher will simulate these instructions on other 
processors. 


The semantics of the privileged system function (PSF) are 
modified for the APU of the 3200MPS Family of Processors. Table 
3-3 lists the mnemonics of machine instructions and mnemonics for 
the Series 3200 Processors. The 16-bit format is not applicable. 
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If these instructions are encountered and the APU option has not 
been specified, the line containing the instruction will be 
flagged on the listing with a pound sign (#). A single DCMD is 
placed in the object code. The text of the DCMD is: 


**k*kXMODULE xxxx CONTAINS APU INSTRUCTIONS 
Where: 
XXxXX is the name of the module. 


The NPWRN instruction can be used to suppress the warning and the 
DCMD output that is generated for instructions not available on 
all processors. 


TABLE 3-3 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS FOR SERIES 3200 PROCESSORS 


| | 32-BIT | 
| INSTRUCTIONS | MNEMONIC | FORMAT | 
| Breakpoint | BRK | RR | 
| Compare alphanumeric (RO=pad) | CPAN | RXRX# | 
| Compare alphanumeric and default | | | 
| pa | CPANP | RXRX# | 
| Load interruptible state | ISRST* | RX | 
| Save interruptible state | ISsv* | RX | 
| Load complement SP register | LCER |} RR | 
| Load complement DP register | LCDR |} RR | 
| Load DP register from SP memory |} LDE |} RX | 
| Load DP register from SP register | LDER | RR | 
| Load DP register from general | | | 
| register pair | LDGR | RR | 
|} Load process state | LDPS* | RX | 
|} Load SP register from DP memory | LED | RX | 
| Load SP register from DP register | LEDR | RR | 
| Load SP register from general | | | 
| register | LEGR | RR | 
| Load general register pair from | | | 
| DP register | LGDR | RR | 
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TABLE 3-3 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS FOR SERIES 3200 PROCESSORS 


(Continued) 
| | | 32-BIT | 
| INSTRUCTIONS | MNEMONIC | FORMAT 
| = SSS STS SS SSS SS SSS SS SL SRS SSS SS SS SS 
Load general register from SP 
register LGER RR 
Load packed decimal string as 
binary LPB RX# 
Load positive DP register LPDR RR 
Load positive SP register LPER RR 
Load process segment table 
descriptor LPSTD* RX 
Load shared segment table 
descriptor LSSTD* RX 
Move and pad (RO=pad) MOVE 
Move and pad default pad MOVEP RXRX# 


vs) 
x 
v8 
~ 
tb 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| x 
Move translated until | MV TU | RXRX# 
| | 
| | 
| | 
| 
| | 
| | 
| 
| | 
| | 
| 


Pack and move PMV RXRX# 
Pack and move absolute PMVA RXRX# 
Read error logger REL* RX1 
Reset memory voltage failure RMVF* RX1+ 
Store DP register in SP memory STDE RX 
Store binary as packed decimal 

string STPB RX# 
Store process state STPS* RX 
Unpack and move UMV RXRX# 
Unpack and move absolute UMVA RXRX# 
Store byte with no ECC XS TB* RX 


Ce ee ee ee ee ee ee ee 


* PSF modified for APU. 


+ No register or other operands allowed in source 
format. 


# These instructions are not supported by the IOP of a 
3200MPS Family of Processors. 


In addition to the set of mnemonics listed in Tables 3-1 through 
3-3, CAL/32 recognizes a complete set of extended branch 
mnemonics. These instructions allow the programmer to call for 
conditional branch instructions without having to. state 
explicitly the condition code (CC) mask. Table 3-4 lists these 
instructions, 
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TO _ _  |___..._..___ ee ee 


TABLE 3-4 EXTENDED BRANCH MNEMONICS 
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Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 


Branch 
Branch 


RO3 


carry 
carry register 
carry short 


no carry 
no carry register 
no carry short 


equal 
equal register 
equal short 


not equal 
not equal register 
not equal short 


low 
low 
low 


register 
short 


low 
low register 
low short 


not 
not 
not 


minus 
minus register 
minus short 


not minus 
not minus register 
not minus short 


plus 
plus register 
plus short 


not plus 
not plus 
not plus 


register 
short 


overflow 
overflow 
overflow 


register 
short 


no overflow 
no overflow register 
no overflow short 
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TABLE 3-4 EXTENDED BRANCH MNEMONICS 


(Continued) 
| INSTRUCTION | MNEMONIC | 
| ba a a no ed | 
| Branch on zero | BZ } 
| Branch on zero register | BZR | 
| Branch on zero short | BZS | 
| | | 
|] Branch on not zero | BNZ | 
| Branch on not zero register | BNZR | 
| Branch on not zero short | BNZS | 
| | 
| Branch unconditional | B | 
| Branch unconditional register | BR | 
| Branch unconditional short | BS | 
| | | 
| No operation | NOP | 
| No operation register | NOPR | 
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The extended branch instructions are essentially single operand 
instructions where the first operand (mask) value is included in 
the operation mnemonic, The programmer supplies only the operand 
or branch location. For short branches, the programmer does not 
have to specify the forward or backward direction. CAL/32 
determines the direction of the branch and generates’ the 
appropriate machine code. For example: 


LOOPL L STRNG, TABLE (PTR) LOAD STRING FROM TABLE 
CLR STRNG , INPUT COMPARE WITH INPUT 
BES END EQUIVALENT FOUND . 
AIS PTR, 4 NOT FOUND INCREMENT PTR 
BNZS LOOP1 GET NEXT STRING 
LIS STRNG , 0 NOT FOUND END OF TABLE 
END ST STRNG, RETURN RETURN VALUE 


In this program, CAL/32 determines the locations of LOOP] and END 
and generates the required forward and backward branch 
instructions. 


Two more CAL/32 instructions that do not have direct machine 
equivalents are: 


INSTRUCTION MNEMONIC 


Branch on true condition short BTCS 
Branch on false condition short BFCS 
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With these 
value and 
forward or 
generated. 


instructions, the programmer must specify the mask 
the branch location. CAL/32 determines the direction, 
backward, and the appropriate machine operation is 


3.5.1 Usual Branch Mnemonics for:the 3280 System 


The Usual Extended Branch Mnemonics instructions supported by the 
3280 System extend the defined set of Extended Branch Mnemonics 
and provide a Usual Branch instruction for each member of the 
Extended Branch Mnemonics set. These instructions operate in a 
way that is similar to the Extended Branch Mnemonics, but will 
allow the user to indicate to the processor that the branch is 


usually taken. This allows the pipeline mechanism to prefetch 
the correct succeeding instruction more frequently, reducing 
delays. Table 3-5 lists these instructions. 
TABLE 3-5 USUAL EXTENDED BRANCH MNEMONICS 
FOR THE 3280 SYSTEM 
| INSTRUCTION | MNEMONIC | 
I 
| Usual branch on carry | UBC | 
|] Usual branch on carry register | UBCR | 
| Usual branch on carry short | UBCS | 
| | | 
| Usual branch on no carry | UBNC | 
| Usual branch on no carry | UBNCR | 
| register | | 
| Usual branch on no carry short | UBNCS | 
| | | 
| Usual branch on equal | UBE | 
| Usual branch on equal short | UBES | 
| | | 
| Usual branch on not equal | UBNE | 
| Usual branch on not equal | UBNER | 
| register | | 
| Usual branch on not equal short | UBNES | 
| 7 | | 
| Usual branch on low | UBL | 
| Usual branch on low register | UBLR | 
| Usual branch on low short | UBLS | 
| | 
| Usual branch on not low | UBNL 
| Usual branch on not low | UBNLR | 
| register | | 
| Usual branch on not low short | UBNLS | 
| | | 
| Usual branch on minus | UBM | 
| Usual branch on minus register {| UBMR | 
|} Usual branch on minus short | UBMS | 
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TABLE 3-5 USUAL EXTENDED BRANCH MNEMONICS 
FOR THE 3280 SYSTEM (Continued) 


| INSTRUCTION | MNEMONIC | 
| Usual branch on not minus | UBNM — 
| Usual branch on not minus | | 
| register | UBNMR | 
| Usual branch on not minus short | UBNMS | 
| Usual branch on plus | UBP | 
| Usual branch on plus register | .UBPR | 
| Usual branch on plus short | UBPS | 
| 

| Usual branch on not plus | UBNP | 
| Usual branch on not plus | | 
| register | UBNPR | 
| Usual branch on not plus short | UBNPS | 
| | | 
| Usual branch on overflow | UBO | 
| Usual branch on overflow | | 
| register | UBOR | 
| Usual branch on overflow short | UBOS | 
| Usual branch on no overflow | UBNO | 
| Usual branch on no overflow | | 
| register | UBNOR | 
| Usual branch on no overflow | | 
| short | UBNOS | 
| Usual branch on zero | UBZ | 
| Usual branch on zero register | UBZR | 
| Usual branch on zero short | UBZS | 
| Usual branch on not zero | UBNZ | 
| Usual branch on not zero | | 
| register | UBNZR | 
| Usual branch on not zero short | UBNZS | 
| Usual branch unconditional | UB | 
| Usual branch unconditional | | 
| register | UBR | 
} Usual branch unconditional short | UBS | 


ee ee ed De 
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3.5.2 CAL/32 Machine Instructions for 3280 System 


In addition to the sets of instructions listed in the preceding 
tables, the 3280 System recognizes a set of new instructions 
which is listed in Table 3-6. See the 3280 System Instruction 
Set Reference Manual for a detailed explanation of these new 
instructions. 


TABLE 3-6 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS FOR 3280 SYSTEMS 
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| | 32-BIT | 
| INSTRUCTIONS | MNEMONIC | FORMAT | 
| Branch and synchronize | BSYNC | oe 
| RX3 

| Branch on count down | BCD | RX3 | 
| Branch on count down backward | | | 
| short | BCDBS | SF | 
| Control/Diagnostic System read | RCDSR | RR | 
| Control/Diagnostic System write | WCDSR | RR | 
| Data base management system | | | 
| checksum | CKSUM | RR | 
| Disable extended real addressing | XMOFF | RR | 
| Enable extended real addressing | XMON | RR | 
| Fill string | FILSC | RXRX | 
| Fill vector with fullword | FILVG | RXRX | 
| Fill vector with doubleword | FILVW | RXRX | 
| Floating point arctangent {| ATNER | RR | 
| Floating point double precision | | | 
| arctangent | ATNDR | RR | 
| Floating point cosine | COSER | RR | 
| Floating point double precision | | | 
| cosine | COSDR | RR 
| Floating point exponential | EXPER | RR | 
| Floating point double precision | | | 
| exponential | EXPDR | RR | 
| Floating point to a floating | | | 
| point power | EXXER | RR | 
| Floating point to a double | | | 
| precision floating point power | EXXDR | RR 
| Floating point logarithm base 10 | L10ER | RR | 
| Floating point double precision | | | 
| logarithm base 10 | L10DR | RR | 
| Floating point natural logorithm | LOGER | RR | 
| Floating point double precision | | | 
| natural logorithm | LOGDR | RR | 
| Floating point sine | SINER | RR | 
| Floating point double precision | | | 
| sine | SINDR | RR 
| Floating point sine and cosine | SNCER | RR | 


Floating point double precision 
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TABLE 3-6 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS 
AND MNEMONICS FOR 3280 SYSTEMS (Continued) 
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| | 32-BIT | 
{ INSTRUCTIONS | MNEMONIC | FORMAT | 
| SEE RE eer Se resem Rree se Sse RRS SSS ese Sse seers eese | 
| sine and cosine | SNCDR | RR | 
| Floating point square root | SQRER | RR | 
| Floating point double precision | | 
| square root | SQRDR | RR | 
| Get user register | GUR | RX | 
| Load real address block | LRAB | RXRX | 
| | Rx3 | 
| Load test control register | LTCR | RX | 
| Load unnormalized |} Lv | RXRX, | 
| | | RX3 | 
| Load unnormalized register | LUR | RR | 
| Load unnormalized double precision | LW | RXRX, | 
| : RX3 
| Load unnormalized double precision | | | 
| register | LWR | RR | 
| Move string | MOVS |} RXRX | 
| Move vector | MOVV | RXRX | 
| Put user register | PUR | RX | 
| Send processor message | GIPS | RR | 
| Start real-time clock | SRTC | RR | 
| Store fullword, no ECC | XSTF | ees 
| RX3 
| Store test control register | STCR | RX | 
| System bus read | RSR | RR | 
| System bus write | WSR | RR | 
| Usual branch on false condition | UBFC | RXRX, | 
| | | RxX3 | 
| Usual branch on false condition | | | 
| register | UBFCR | RR | 
| Usual branch on false condition | | | | 
| backward short | UBFBS | SF | 
| Usual branch on false condition | | | 
| forward short | UBFFS | SF | 
| Usual branch on true condition | UBTC | RXRX, | 
RX3 
| Usual branch on true condition | | | 
| register | UBTCR | RR 
| Usual branch on true condition | | | 
| backward short | UBTBS | SFE | 
| Usual branch on true condition | | | 
| forward short | UBTFS | SF | 


When any of the 3280 System commands are encountered during 
assembly, a pound sign (#) will be printed in the first column of 
the line if a listing is requested and a single DCMD will be 
placed in the object code. The text of the DCMD is: 


3-28 48-050 FOO RO3 


****k MODULE xxxx CONTAINS 3280 SYSTEM INSTRUCTIONS 
Where: 
XXxXX represents the name of the program. 


The no processor specific warning (NPWRN) instruction can be used 
to suppress the warning and the DCMD output that is generated for 
instructions not available on all processors. 


3.5.3 Instructions for the Input/Output Processor (IOP) 


There are machine instructions to be used only on an IOP for’ the 
3230MPS and 3260MPS. Table 3-7 provides a summary of these 
instructions and the applicable format. See the appropriate 
Instruction Set Reference Manual for a detailed explanation of 
these machine instructions. 


TABLE 3-7 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 
FOR IOPs 
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| | | 32-BIT | 
| INSTRUCTIONS | MNEMONIC | FORMAT | 
| CPU attention | ATCPU | RR | 
| Exit | xXIT | RR | 
| Load APB } LAAPB | RR | 
| Load ISP | LAISP | RR | 
| Load wait time | LDWT | RR | 
| Post interrupt | PINT | RR | 
| Reset lock | RLOCK | RR | 
| Set lock } SLOCK | RX | 
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When an IOP instruction is encountered, the line containing the 
instruction on the listing is flagged with a pound sign (#). A 
single DCMD is placed in the object code. The text of the DCMD 
is: 


**** MODULE xxxx CONTAINS I/O PROCESSOR INSTRUCTIONS 
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Where: 


XXXX is the name of the module. 


The NPWRN instruction can be used to suppress the warning and the 
DCMD output that is generated for instructions not available on 
all processors. 


3.6 ASSEMBLER INSTRUCTIONS 


Assembler instructions control the assembly process. Although 
they may resemble machine instructions in form, they do not 
generate any machine executable code. They are used to define 
symbols, reserve storage, generate data constants and control the 
final output. 


3.6.1 Symbol Definition Instructions 

Symbol definition instructions allow the programmer to assign 
values to symbols and set up communication paths between 
separately assembled programs. The latter operation facilitates 
the use of subroutines because they can be written and assembled 
separately from the main program. At load time, a linking loader 
uses information supplied by CAL/32 to resolve addresses between 
main programs and subroutines to set up the correct linkage. 
3.6.1.1 Equate (EQU) Instruction 

This is one of the most commonly used assembler instructions. It 
assigns values to symbols and it has the form: 


NAME OPERATION OPERAND 


A symbolic name EQU An expression 


Examples of EQU instructions are: 


LOOP EQU LOOP1 

TOP EQU END-—6 4 
DELTA EQU BOTTOM- TOP 
HERE EQU = 

START EQU X'10OFE' 
SUM EQU 1 

PTR EQU 2 


3-30 48-050 FOO RO3 


EQU instructions can appear anywhere in the program. CAL/32 
requires that each EQU instruction have a symbol in the name 
field and treats the absence of this symbol as an error. The 
value assigned to a symbol by an EQU instruction is absolute or 
relocatable, depending on the type of expression in the operand 
field. 


If the operand of an EQU statement contains a forward reference, 
CAL/32 will perform any additional passes required to define all 
symbols. CAL/32 does not reserve storage for symbols defined by 
an EQU instruction. Wherever it encounters the symbol in the 
program, CAL/32 replaces the symbol with the value defined in the 
EQU instruction. For example: 


STRNG EQU 1 

PTR EQU 2 

INPUT EQU 3 

LOOPI L STRNG , TABLE (PTR) LOAD STRING FROM TABLE 
CLR STRNG , INPUT COMPARE WITH INPUT 


In this case, CAL/32 generates the code to load register 1 with 
four bytes located at the address specified by TABLE, indexed by 
register 2. The next instruction causes CAL/32 to generate the 
code to compare the four bytes in register 1 with the contents of 
register 3. The use of the EQU instruction here allows the 
programmer to assign meaningful names to the registers that hold 
the character strings, and index into the table. It also 
provides a simple way to redefine the values assigned to these 
symbols. By changing the EQU instructions and reassembling, it 
is possible to change the values assigned to the symbols without 
extensive editing to change each individual statement where these 
registers are used. 


It is also possible, although not recommended, to redefine a 
symbol within a program. For example: 


LOOP1 EQU * 


LOOP1 EQU . 


When the symbol LOOP1l is encountered in the first EQU 
instruction, CAL/32 assigns it the value of the LOC. Subsequent 
references to LOOP] receive this value. Following the second EQU 
instruction, the value of LOOP] is changed to the value of the 
new LOC. Because such redefinitions might not be intentional, 
CAL/32 issues a warning message wherever a symbol is redefined by 
an EQU instruction. (In the example, the programmer might have 
intended to write LOOP2 instead of LOOP] in the second EQU 
instruction.) 
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The user must guard against circular LOC dependency, as shown in 
the following example: 


A EQU * 
DS 7 
DS B-A 

B EQU * 
END 


CAL/32 will flag an "MOO1 xxxTOP" error where xxx is PURE, IMP, 
or ABS, depending upon the current LOC. 


As stated earlier, CAL/32 permits the user to define operation 
mnemonics within the program. To do this, the user defines the 
new mnemonic in an EQU instruction in which the new operation 
mnemonic is in the name field and the operand field contains a 
hexadecimal constant of the form X'nnxy'. Here, nn is the 
machine language operation code, and x and y are descriptors that 
tell CAL/32 how to handle the new mnemonic. The values of x and 
y inform CAL/32 of the instruction format. The values are 
defined as follows: 


x = 0, y = 8 RR or SF format 
x = 0, y = 2 RX or RI format 
xX = 0, y= 4 RIl format 
x = 0, y=l RI2 format 


To define extended branch mnemonics, x gets a value equal to the 
Rl field (mask) and y gets one of the following values: 


y = 3 RX format 
y=cC RR format 
y =D SF format 


For example, in the instruction: 


BTC 15,ADDR 


the branch on true condition mnemonic and the mask field 15 can 
be combined into an extended branch instruction as follows: 


BTCF EQU X'42F3! 


in which BTCF is the new mnemonic; 42 is the machine code for the 
branch on true condition instruction; F is the mask value (15); 
and 3 specifies RX format. Once this new mnemonic is defined, 
the programmer can write: 
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BTCF ADDR 
instead of: 
BTC 15,ADDR 


The new mnemonic definition remains in effect only for the 
program in which it is defined. The new mnemonic must be 
different from all other mnemonics recognized by CAL/32. 


There are three things to remember in using equate statements: 


1. The name field must always contain a valid symbol. 


2. The operand field must always contain a defined symbol or 
expression. 


3. The symbol that appears in the name field of an Equate 
instruction must not appear in the name field of any other 
instruction, except another Equate instruction. 


If any of these rules are violated, CAL/32 generates an 
appropriate error message, 


3.6.1.2 External, Entry, Weak External, Weak Entry and Data 
Entry (EXTRN, ENTRY, WXTRN, WNTRY and DNTRY) 
Instructions 


These instructions are listed together since they perform 
corresponding functions to establish links between main programs 
and subroutines, and between programs with a common data base. 
These instruction forms are: 


NAME OPERATION OPERAND 
Not used EXTRN One or more symbols 
(illegal) separated by commas 
Not used ENTRY One or more symbols 
(illegal) separated by commas 
Not used WXTRN One or more symbols 
(illegal) separated by commas 
Not used WNTRY One or more symbols 
(illegal) separated by commas 
Not used DNTRY One or more symbols 
(illegal) separated by commas 
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The EXTRN instruction identifies symbols referenced by the 
program but defined outside the program. The ENTRY instruction 
identifies symbols defined within the program and referenced 
externally. (They can be referenced internally as well.) | 


OS/32 supports a 24-bit addressing mode and a 32 bit value mode. 
EXTRN and ENTRY instructions are designed for addresses rather 
than values and may only hold a 24-bit address. Using these 
instructions for 32-bit values produces unexpected results. 


For example, consider two programs: one calculates the sine and 
cosine of an angle, the other uses the sine and cosine. The 
first is a general-purpose program that could be used by many 
other programs. The ENTRY and EXTRN instructions make this 
possible without having to assemble the sine and cosine program 
every time it is needed, The sine and cosine program would 
contain an ENTRY instruction and entry points such as: 


ENTRY SIN,COS 
SIN EQU bs 


COs EQU 7 


The symbols SIN and COS appear as operands in the ENTRY 
instruction and as names in the EQU instructions. When CAL/32 
assembles this program, CAL/32 informs the linking loader’ that 
the locations identified by the names’ SIN and COS are entry 
points into the program. 


The program that uses sine and cosine would contain an external 
statement and branch instructions such as: 


EXTRN SIN,.COS. 


e 


BAL LINK, SIN 


BAL LINK, COS 
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At assembly time, CAL/32 generates object data to inform the 
linkage editor that the symbols SIN and COS are externally 
Gefined. At link time, the linkage editor uses this information, 
along with the information generated by the Entry instruction in 
the other program, to provide the necessary linkage. 


NOTE 


See the 0OS/32 Link Reference Manual for 
information on linking multiple object 
modules, 


The WXTRN instruction is essentially equivalent to the EXTRN 
instruction. However WXTRN symbols are subject to the following 
exception processing by Link: 


e An error condition does not arise if the symbol is not 
resolved. A warning message, n UNDEFINED WEAK EXTERNAL 
SYMBOL(s), is output if any weak external symbols’ remain 
unresolved after the image is built. ; 


e Object libraries are not searched in order to satisfy a weak 
external. 


e If a module containing an entry point referenced by a WXTRN 
symbol is included, then the entry point will be used to 
satisfy WXTRN references to it in the normal way. 


The WNTRY instruction is essentially equivalent to the ENTRY 
instruction. However, WNTRY symbols are subject to the following 
exception processing by Link. 


@® Weak entry points are not examined when searching an object 
library. Therefore, a program module containing a weak entry 
point is not included to satisfy an external reference. 


e If a program module containing a weak entry point is included 
from a module, the weak entry point will be used to satisfy 
external references in the normal way. 


The DNTRY instruction is essentially equivalent to the ENTRY 
instruction. Rather than providing access to executable code 
being referenced by another module, DNTRY provides access to 
labeled data areas. When building overlaid modules, one overlay 
may require access to a data area identified in another overlay. 
The DNTRY instruction is used to identify these labeled data 
areas in overlay modules. This instruction identifies a symbol 
defined local to the program containing the DNTRY instruction. 
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To help protect references to data in higher level nodes, Link 
automatically loads the entire path of overlays starting at the 
overlay containing data and ending with the overlay making the 
reference to a data entry point (DNTRY). A reference to a 
program section positioned in a higher level node, via _ the 
POSITION command, is treated the same way. A reference to data 
or a program section in the root does not cause a path of 
overlays to be loaded. 


If a DNTRY is referenced in a lower level node, an SVC5 manual 

overlay load might be required to ensure that the overlay is in 

memory at the time of the reference. 

Restrictions on the use of external and entry instructions are: 

e The operand field of an external instruction must not contain 
an expression, such as SIN+4. 

e Expressions involving externally defined symbols must be of 
the form: 


- External symbol + absolute expression 


- External symbol - absolute expression 
BAL R15 ,SIN+4 
is a legal use of an externally defined symbol. 
@e Externally defined symbols cannot be used internally as 


instruction identifiers. 


e Any symbol identified as an entry must appear internally in 
the name of an instruction. 


e Symbols identified as entries cannot be redefined by multiple 
equate instructions. 

3.6.1.3 Include (INCLD) Instruction 

This information provides Link with a mechanism to guarantee the 


inclusion of object modules without other linkage references to 
it. It has the form: 


NAME OPERATION OPERAND 
Not used INCLD One or more symbols 
(illegal) separated by commas 
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The INCLD is used in the same fashion as the EXTRN to linking 
references. However, this instruction is used to nominate 
program modules rather than external symbols. 


NOTE 


CAL/32 generates the same object as in 
the past, provided none of the following 
instructions are _ used: external with 
offset, DCMD, DNTRY, WNTRY, WXTRN' or 
INCLD. The assembly of any of these 
instructions produces an object that TET 
will reject. Link is required to process 
modules containing this extended object. 
These instructions are only valid in a 
Target 32 assembly and have no effect on 
16-bit object generation. 


3.6.2 Data Definition Instructions 


The following instructions allow the programmer to reserve areas 
of memory to be used at run-time. Some of these instructions 
allow the programmer to specify values with which these areas can 
be initialized at load time. Other data definition instructions 
provide easy access to complex data structures. 


3.6.2.1 Define Storage (DS, DSH and DSF) Instruction 
This instruction causes CAL/32 to reserve a block of storage 


within the program without initializing the reserved locations to 
any value. It has the form: 


NAME OPERATION OPERAND 
A symbol DS A previously defined absolute 
(optional) expression 
A symbol DSH A previously defined absolute 
(optional) expression 
A symbol DSF A previously defined absolute 
(optional) expression 


The DS mnemonic causes CAL/32 to reserve the specified block of 
storage starting from the value of the current LOC. 
In the DSH form, CAL/32 first aligns the LOC on a halfword 
boundary and then reserves the storage. In the DSF form, CAL/32 
first aligns the LOC on a fullword boundary. Examples of the 
define storage instruction are: 


48-050 FOO RO3 | 3-37 


BUF1 bs 100 
BUF2 DSH 125 
BUF3 DSF 16 


In the first example, CAL/32 reserves 100 bytes of storage by 
simply adding 100 to the LOC. In the second example, CAL/32 
reserves 125 halfwords (250 bytes) of storage. CAL/32 does this 
by aligning the LOC on a halfword boundary, if it is not already 
properly aligned, and then adding 250 to it. In the third 
example, CAL/32 ensures that the LOC is aligned on a fullword 


boundary and then adds 64 (the byte equivalent of 16 fullwords) 
to it. 


Define storagé instructions are commonly used to reserve storage 
areas for transient data. Examples of this are I/O buffers and 
register save areas. For example: 


ENTRY RSAVE 
| EXTRN SIN, COS 
LINK EQU 15 


BAL LINK, SIN 


RSAVE DSF 16 


shows how a main program might set up a register save area within 
itself. The code for the called program might look like: 


ENTRY SIN,COS 
EXTRN RSAVE 
RO EQU 0 


SIN FQU  * 
STM  RO,RSAVE 


where the subroutine stores the general registers in the 
externally defined area, RSAVE. When using define storage 
instructions remember that: 
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e The DSH and DSF forms of the instruction ensure halfword and 
fullword alignment. 


e The define storage instructions do not initialize memory to 
any particular value. 


@ Only one operand is allowed in a define storage instruction, 
and it must be a defined, absolute symbol or expression. 


3.6.2.2 Define Constant (DC and DCF) Instruction 


The define constant instruction allows the programmer to reserve 
areas of memory and at the same time specify the initial value to 
be loaded into them. The define constant instruction has two 
forms: 


NAME OPERATION OPERAND 
A symbol DC One or more operands 
(optional) separated by commas 
A symbol DCF One or more operands 
(optional) separated by commas 


The DC mnemonic ensures that the first of the operands is aligned 
on a halfword boundary. The DCF mnemonic ensures that the first 
of the operands is aligned on a fullword boundary. Operands of 
different types can be used in the same define constant 
instruction. However, where alignment is a concern, the 
programmer must be careful in mixing operands of different types. 
Types of operands are described below. 


A single character code indicates the type of constant. This 
character code is not always required, and the exceptions are 
noted as they occur. The assembler determines from the character 
code how it is to interpret the constant and translate it into 
the proper object format. Table 3-8 lists the character codes 
recognized by CAL/32, their meanings, and the types of constants 
generated. 
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TABLE 3-8 CONSTANT TYPES 


string integer of 7-bit ASCII 
encoded decimal digits 
(8-bits per digit) ina 
string of variable byte 
length. 


ee eee Gee re OR ee Se Se SE ES Gee Gee SE Gee See Ome OEE Gee Ge ame Pe ae ee Se eee ee Oe Ee OP OT Ge OF OE ame OF FE Se Se OF Be Om Gn SN GR EE Ge art Gm See Oe oe 


| CODE | MEANING | MACHINE FORMAT | 
| x | Hexadecimal | 16-bit binary | 
|} Y | Hexadecimal | 32-bit binary | 
| H | Integer | 16-bit signed binary | 
| F | Integer | 32-bit signed binary 
| A | Address | 32-bit value of address | 
| 2 | Address | 16-bit value of address | 
| | Address | One half of 16-bit address | 
| £ | Single precision | 32-bit floating point | 
| | floating point | format | | 
} OD | Double precision | 64-bit floating point | 
| | floating point | format | 
} Cc | Character | An 8-bit code per | 
| | | character (7-bit ASCII) | 
| P | Packed decimal | Fixed point sign-coded | 
| | string | integer of binary en- | 
| | | coded 4-bit decimal | 
| | | digits in a string of | 
| | | variable byte length. | 
| U | Unpacked decimal | Fixed point sign-coded | 
| | | 

| | | | 
| | | | 
| | | | 
| | | | 


3.6.2.3 Hexadecimal Constants 


A hexadecimal constant consists of one or more hexadecimal 
digits, 0 through 9 and A through F, enclosed in apostrophes and 
preceded by the type code X or Y. Where the X type is’ used, 
CAL/32 reserves two bytes of storage and generates the loader 
information that will cause those two bytes to be initialized at 
load time with the binary representation of the hexadecimal 
number. The Y type causes four bytes to be reserved and 
initialized. Examples of hexadecimal constants are: 


CONSTANT VALUE 
DC X'1234' 1234 
DC y¥'1234' 0000 1234 
DCF xX'20' 0020 
DCF yY‘'0064' 0000 0064 


DC X'123 4ABC' 4ABC 
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The first example shows a halfword hexadecimal constant which, 
because of the DC operation code, is aligned on a halfword 
boundary. The second example shows a fullword hexadecimal 
constant. In this case, fullword alignment is not guaranteed. 
The third example shows a halfword constant aligned on a fullword 
boundary. The fourth example shows how to force fullword 
alignment for a fullword constant. The last example shows what 
happens when too many digits are given. CAL/32 truncates' the 
constant to the least significant digits and generates an error 
message. The maximum number of digits for an X type constant is 
four. The maximum number for a Y type constant is eight. 


NOTE 


Where fewer than the maximum number of 
Gigits are given, CAL/32 right-justifies 
the value in the location and fills in 
the missing digits with zeros. 


Two special mnemonics facilitate the building of hexadecimal 
tables by eliminating the need to specify the X or Y type code. 
They have the form: 


NAME OPERATION OPERAND 
A symbol DCX One or more operands 
(optional) separated by commas 
A symbol DCY One or more operands 
(optional) separated by commas 


Operands for these instructions consist of one to four 
hexadecimal digits for the DCX instruction and one to eight 
hexadecimal digits for the DCY instruction. Examples of these 
constants are: 


DCX 1,0,14AE,20,4040 
DCY 1,2FFFE,64,80000000 


The DCX instruction generates five halfword constants: 


0001 
0000 
14AE 
0020 
4040 
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The DCY instruction generates four fullword constants: 


0000 0001 
0002 FFFE 
0000 0064 
8000 0000 


Before generating the constants, CAL/32 ensures that they are 
properly aligned with halfword constants aligned on halfword 
boundaries and fullword constants aligned on fullword boundaries. 


3.6.2.4 Integer Constants 


Integer constants can be either halfword or fullword. Halfword 
constants are expressed by the character code H followed by a 
string of from one to five decimal digits enclosed in 
apostrophes. Fullword constants are expressed by the character 
code F followed by a string of from one to ten decimal digits 
enclosed in apostrophes. The range of halfword constants is from 
-2'5 to 26 - J. The range of fullword constants is from -23' to 
231 - 1. The range of halfword and fullword constants is shown 
below. The decimal strings used in these constants must not 
include commas or blanks. A sign, + or -, can precede the 
string. 


ne ame Gee 2 Ge: EE Ge re ee Ge Oe OE EE Cee ER Oe OF EEE Se ee Se Ge Oe OF Gn GFE ee OE om Oe 


| MINIMUM VALUE | MAXIMUM VALUE | 


| Halfword | -32768 | +32767 | 


| ee Gas GON SNe SA GER SE GEE GES GEE Gee GRE GS GEE Gm: SFT Ge GU GE GES Ger Gan Gon GO Ges OF Ger GD Os ae OF OF Om ER On GR OS OF ow 


| Fullword | -2147483648 | +2147483647 | 


The internal representation of integer constants is two's 
complement binary. In this notation, positive numbers and zero 
have their true binary form. For example, a halfword integer 
with a value of 25 is represented internally (hexadecimal 
notation) as 19. 


Negative numbers are expressed in accordance with the formula: 


Value = 2" - x 
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where n is the number of bits used to express the value, and x is 
the absolute value of the number. For example, to represent 
minus, 10 in a halfword constant: 


n 16 (1046 ) 
x 10 (At6 ) 
Value = 1000016 - Aig = FFF616 


Examples of integer constants are: 


CONSTANT | VALUE 


DC H'32767' 7FFF 
DC H'-32768' 8000 
DC Pelt 0000 0001 
DC Ht=2" FFFE 
DCF F'25' 0000 0019 


The H and F codes themselves do not guarantee correct alignment. 
To ensure that a fullword integer is aligned on a fullword 
boundary, the programmer should use the DCF instruction. 


CAL/32 does not require that integer constants be defined with 
the character codes and decimal strings enclosed in apostrophes. 
A simple decimal string can be used. For example: 


DC 1 
DC -7 


The length of the integer constants generated by these 
instructions depends on the processor on which the program is to 
run. For 32-bit processors such instructions generate fullword 
constants, such as: 


CONSTANT VALUE 
DC 1 0000 0001 
DCF -7 FRFF FFF9 


For 16-bit processors, these instructions generate halfword 
constants, such as: : 


CONSTANT VALUE 
DC 1 0001 
DC mT. FFF9 
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It is possible to force a fullword alignment by using the DCF 
mnemonic with a simple decimal string. The use of a DCF 
instruction affects only the alignment of the first of the 
integer constants; the length of the constant is determined 
solely by the processor on which the program is to be run. Thus, 
when using these instructions with operands which are simple 
decimal strings, it is not possible to generate a halfword 
constant for a 32-bit processor. 


3.6.2.5 Address Constants 


Address constants consist of a single character type code 
followed by a symbol or an expression enclosed in parentheses. 
The three types of address constants are A, 2% and T. Type A 
constants generate fullword address constants in programs 
intended to be run on 32-bit processors; they generate halfword 
address constants in programs intended to be run on 16-bit 
processors. Types Z and T address constants always generate 
halfword values. Examples of address constants are: 


DC A(LOOP+2) 

DC A( TABLE) 

DC A(TOP-BOTTOM) 
DC Z (IOVECTOR) 
DC T (ALPHATAB ) 


For 32-bit processors, the first three examples cause CAL/32 to 
reserve a fullword of storage, initialized at load time to 
contain the value of the expression or symbol enclosed in 
parentheses. This value can be absolute or relocatable, 
depending on the nature of the expression. The address quantity 
is right-justified in the least significant 24 bits of the 
fullword, and the most significant eight bits are forced to zero, 
However, it is possible to use the most significant bits for some 
purpose, They might be used as flag bits as in the example: 


PARAM DS 4 

ADDR DC A(PARAM+Y'A0000000') 
EXTRN SIN 

LINK EQU 15 

ADREG EQU 14 


STE RO, PARAM 
L ADREG , ADDR 
BAL LINK, SIN 
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At the time of the branch and link instruction, register 14 
contains the address of the location PARAM in the least 
Significant 24 bits. The most significant eight bits contain the 
value X'AO'. The subroutine can use the address portion and the 
flag portion independently, as: 


SIN EQU * 
LE R4 ,0 (ADREG) GET PARAMETER 
TI ADREG, Y'A0000000' TEST FLAGS 


The Z type address constants generate halfword values. They can 
be used in programs for 32-bit processors if the programmer is 
certain that the actual address cannot exceed 65,535, the maximum 
unsigned value that can be expressed in a halfword. 


The T type address constants are used as entries in translation 
tables. These instructions cause CAL/32 to reserve a halfword of 
storage initialized with one half of the actual address, right 
justified. The most significant bit is zero. These constants 
are intended for use with the translation tables associated with 
the Translate instruction and with the auto driver channel. 


Address constants can be written without the type code and 
parentheses, as in: 


TABLE DS 16 

BUFF1 DS 64 

ADD1 DC TABLE ADDRESS OF TABLE 

ADD2 DC BUFF1 ADDRESS OF BUFFER ONE 


Where this convention is used, the size of the generated constant 
depends on the processor for which the program is written. For 
32-bit assemblies, CAL/32 generates fullword constants. For 
16-bit assemblies, CAL/32 generates halfword constants. The 
programmer can force halfword constants to be generated by using 
the mnemonic DCZ, as: 
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DCZ TABLE, BUFF1 


which causes a series of halfword address constants to be 
generated. 


3.6.2.6 Floating Point Constants 


The source form for floating point constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
E for single precision, or the letter D for double precision. 
The decimal number consists of: 


@® an optional plus sign or minus sign, 
@ one or more decimal digits that may include a decimal point, 


® an optional E character followed by an optional plus sign or 
Minus sign, followed by one or two decimal digits denoting a 
power of 10. 


Single precision floating point constants require a fullword of 
storage, Double precision floating point constants require a 
doubleword of storage. Internally, floating point constants are 
represented in excess 64 notation. In this kind of notation, 
each floating point number consists of a sign, an exponent and a 
fraction. The first bit of the number is the sign bit. If this 
bit is al, the number is negative; if it is a 0, the number is 
positive. The next seven bits represent the exponent, expressed 
in excess 64 notation. This field can contain any value between 
0 and 127 inclusive. The remaining bits, 24 for single precision 
and 56 for double precision, represent the fraction with an 
implied radix point before the first bit. 


The true value of the floating point number is obtained by 
multiplying the fraction by 16 raised to the power indicated by 
the exponent field. In excess 64 notation, this power is 
determined by subtracting 64 from the value in the exponent 
field. In this way, values equal to or greater than 64 produce 
a 0 or positive power. Raising 16 to this power and then 


multiplying by the fraction produces values between 
.0625 and 7.2 x 107°, Exponent field values that are less than 64 
produce a negative power and values between 


.06249,.. and 5.4 x 10°78, Ploating point 0 is represented by a 
fullword or a doubleword of zeros, 


See the appropriate Processor User Manual for more detailed 
information. 
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Examples of floating point constants are: 


CONSTANT INTERNAL ‘REPRESENTATION 
DC E'l' 4110 0000 

DC E'0.0' 0000 0000 

DC E'7.2E74' 7F19 7817 

DC D'10.5' 41A8 0000 0000 0000 
DC D'5 .4E-79' 0010 01D1 33A9 49F6 


DC D'7.2E+75' 7FFE BOE3 AD97 8760 


In the internal representation of floating point constants, the 
fractional part can consist of from one to six hexadecimal digits 
for single precision, and up to 14 hexadecimal digits for double 
precision. If the decimal number exceeds this degree of 
accuracy, the magnitude of the number is preserved but the 
precision is lost. In performing the conversion from decimal to 
internal floating point, CAL/32 carries guard digits to ensure 
six hexadecimal digit accuracy for single precision and 14 
hexadecimal digit accuracy for double precision. The programmer 
must ensure proper alignment. 


3.6.2.7 Character Constants 


Character constants consist .of the single letter code C followed 
by a string of ASCII characters enclosed in apostrophes. All 
characters are translated into 7-bit ASCII, in which the most 
Significant bit is always 0. Examples of character constants 
ares 


DC C'NAME' 
DC C'APOSTROPHE = '' ! 


The second example shows how an apostrophe is included in a 
character constant. Between enclosing apostrophes, a double 
apostrophe is treated as a single character. The maximum number 
of characters that can be defined in a Single character constant 
is 64. If the number of characters in a constant is odd, CAL/32 
appends a blank character at the end to maintain halfword 
alignment. 


3.6.2.8 Decimal String Constants 


The source format for decimal string constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
P for packed decimal string constants, or by the letter U for 
unpacked decimal string constants. The decimal number is an 
integer and consists of an optional plus sign or minus sign, 
followed by 1 to 31 decimal digits. 
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The machine internal representation of the packed decimal string 
constant is a fixed point, sign-coded integer, where each digit 
occupies four bits and each byte holds two digits. That is, each 
Gecimal digit, 0 through 9, is binary encoded in a 4=bit 
hexadecimal digit. As the number of decimal digits varies from 
1 to 31, the length in bytes of the decimal string varies from 1 
to 16 bytes. The last hexadecimal digit contains a 4-bit code 
for sign; a hexadecimal C for plus or a hexadecimal D for minus. 


The integer representation is right-justified within the variable 
length string, so the least significant digit of the decimal 
number occupies the hexadecimal digit just preceding the sign 
code, Each digit is thus consecutively packed, with the most 
Significant digit (zero or nonzero) in bit positions 0 through 3 
of the left-most byte of the string. See the examples. that 
follow for the differences in internal representation, when the 
packed decimal string constant is defined by either the Define 
Constant (DC) instruction or the Define Byte (DB) instruction. 


The machine internal representation of the unpacked decimal 
string constant is a fixed point, sign-coded integer, where each 
zoned digit occupies a byte. That is, each decimal digit, 0 
through 9, is encoded in 7-bit ASCII with the left-most bit 0 
providing an 8-bit byte with the left hexadecimal digit 
containing a zone code of 3 and the right hexadecimal digit 
containing the binary encoded decimal digit. As the number of 
decimal digits varies from 1 to 31, the length in bytes of the 
decimal string varies from 1 to 31 bytes. The integer 
representation is right-justified within the variable length 
string. The right-most byte contains the least significant digit 
in its right-most hexadecimal digit and the sign code in its 
left-most hexadecimal digit. The sign code is a 4-bit code, 
described above with a hexadecimal C for plus and a hexadecimal 
D for minus. Each digit is thus consecutively coded into bytes, 
with the most significant digit (zoned zero or zoned nonzero). 
See the following examples for the differences in internal 
representation, when the unpacked decimal string constant is 
defined by either the DC instruction or the DB instruction. 


The address of the string is the address of the left-most byte 
containing the most significant digit (zero or nonzero). The 
address generated for either the packed decimal string constant 
or the unpacked decimal string constant is that associated with 
the label of the source statements and the current LOC. 
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Examples of the packed decimal string (PDS) constants are: 


INTERNAL 

REPRESENTATION 
SOURCE FORMAT | (HEXADECIMAL) 
DB P'l! ic 
DB P'+50! - 2.” 050C 
DB P'-879! : - 879D 
DB P'+1234' | : 0123 4c 
DB P'-12345' 1234 5D 


DB "1234567890123 4567 8901234567 8901 " 1234 5678 9012 3456 
7890 1234 5678 901C 


pc Plt ; 001Cc 
DC P'+50! 050C 
CD P'-879! 879D 
DC P'+1234! 0001 234C 
DC P'12345' 0012 345¢C 


DC P'123 4567 890123 4567 89012345678901' 1234 5678 9012 3456 
7890 1234 5678 901C 


Note that as string-processing instructions are intended to 
operate at the lowest addressable level, on byte-addressable 
locations, these constants are most efficiently generated by the 
DB instructions described in the define byte instruction section. 
If the DC instruction is used, an extra byte of leading zeros is 
generated when the number of digits is a multiple of 4 or is an 
odd number of digits not divisible by 3. Examples of unpacked 
decimal string (zoned) constants are: 


INTERNAL 

REPRESENTATION 
SOURCE FORMAT (HEXADECIMAL) 
DB U'l'! Cl 
DB U'+50! 35C0 
DB U'-879! 3837 D9 
DB U'+1234' 3132 33C4 
DB U'12345' 3132 3334 C5 


DB U'123 4567890123 4567 890123 45678901' 3132 3334 3536 3738 
3930 3132 3334 3536 
3738 3930 3132 3334 
3536 3738 3930 Cl 


DC Ul! 30Cl1 

DC U'+50' 35C0 

DC U'-879! 3038 37D9 

DC U'+1234' 3132 33C4 

DC U'-12345' 3031 3233 34D5 


DC U'123 4567 890123 4567 890123 45678901' 3031 3233 3435 3637 
3839 3031 3233 3435 
3637 3839 3031 3233 
3435 3637 3839 30Cl1 
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As string-processing instructions require programmed length 
attributes, familiarization with the internal storage 
requirements for both packed decimal string and unpacked decimal 
string constants is advisable. In the previous examples, the 
relationship of number of digits to byte length is as follows: 


CONSTANT DEFINED BY BYTE LENGTH 


Packed DB (integer of n/2) + 1 
Packed DC 2*(integer of n/4) + 2 
Unpacked DB n 

Unpacked DC n, for n even 


n+1, for n odd 


where n is the number of decimal digits in the source formats of 
the decimal constants. 
3.6.3 Define Byte (DB) Instruction 


This instruction defines consecutive 8-bit bytes of data. It has 
the form: 


NAME OPERATION OPERAND 
A symbol DB One or more operands 
(optional) separated by commas 


The symbol used in the name field of the DB instruction is 
assigned the value of the current LOC. There is no automatic 
alignment. The programmer must ensure proper alignment where the 
symbolic name of a DB instruction is used as an operand 
identifier in an instruction requiring its operand to be located 
on a halfword, fullword or doubleword boundary. 


The operand field can contain one or more operands, separated by 
commas, There can be an even or an odd number of operands. The 
operands can be any symbol or expression value. For any operand 
other than character or decimal string expressions, the least 
significant eight bits of the operand value are used to generate 
one byte of data. Examples of the DB instructions are: 


DB X' FT! 

DB 128 

DB =] 

DB C'at 

DB C'ABCDEFG! 
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As seen in the examples, the operand of a DB instruction can be 
a Signed integer. In this. case, the integer can have any value 
between -128 and +127, inclusive. 


A special form of the DB instruction: 
DB * 


forces alignment of the LOC to a halfword boundary. If, when 
this instruction is encountered, the LOC contains an odd value, 
one byte of zero value is generated, and the LOC is made _ even. 
If the LOC is already even, this instruction has no effect. 

3.6.4 Define List (DLIST) Instruction 

This instruction provides a simple means for defining circular 
lists used by the machine instructions: 

e Add to top of list 

@ Add to bottom of list 


e Remove from top of list 


@e Remove from bottom of list 


The Define List instruction has the form: 


NAME OPERATION OPERAND 
A symbol DLIST A previously defined absolute 
(optional) expression 


The absolute expression in the operand field specifies the number 
of slots in the list. For 32-bit assemblies, CAL/32 reserves 
four halfwords of storage for list pointers, followed by the 
specified number of fullwords (slots). The first halfword list 
pointer is initialized with a value equal to the number of slots 
in the list. The remaining three pointers are initialized to 
zero, For 16-bit assemblies, CAL/32 reserves four bytes of 
storage for list pointers, followed by the specified number of 
halfwords. The first byte pointer is initialized to a value 
equal to the number of slots in the list. The remaining byte 
pointers are initialized to zero. An example of the DLIST 
instruction is: 


LISTI1 DLIST 100 
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In a 32-bit assembly, this has the same effect as: 
LIST1 DCF X'64',X'0',X'0',X'0! 
DS 400 


The DLIST instruction forces alignment to a fullword boundary in 
32-bit assemblies. It forces alignment to a halfword boundary 
for 16-bit assemblies. 


3.6.5 Define Command (DCMD) Instruction 


This instruction causes the string within the set of apostrophes 
to be passed directly to the object code. 


NAME OPERATION OPERAND 
A symbol DCMD C'command string' 
(optional) 


The operand of the DCMD instruction is subject to the _ same 
syntactic rules as any other character string. CAL/32 performs 
no syntax checking on the command string. 


CAL/32 will generate the same object as in the past, provided the 
DCMD instruction is not used. The assembly of this instruction 
will produce an object that TET will reject. Link is required to 
process modules containing this extended object. The DCMD 
instruction is valid only in a Target 32 assembly and has _ no 
effect on the 16-bit object generation. 


3.6.6 Location Counter (LOC) Instructions 


The following instructions allow the programmer to. select the. 
current LOC and set its value. For 32-bit assemblies, CAL/32 
maintains three LOCs: pure, impure, and absolute. For 16-bit 
assemblies, it maintains two LOCs: relocatable and absolute. At 
any given time, only one LOC can be in use. With these 
instructions, the programmer can control the program segmentation 
and relocation. 


3.6.6.1 Pure (PURE) Instruction 


This instruction causes all subsequent machine instructions to be 
assembled as part of the pure segment. It has the form: 


NAME OPERATION OPERAND 
A symbol PURE None 
(optional) (ignored) 
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The current LOC is saved and the new LOC is set to point to the 
next halfword boundary beyond the most recently used location in 
the pure segment. If a PURE instruction occurs ina relocatable 
16-bit program, it has no effect. If it occurs in an absolute 
16-bit program, it causes a switch to the relocatable LOC. 


3.6.6.2 Impure (IMPUR) Instruction 


This instruction causes all subsequent instructions to be 
assembled as part of the impure segment. It has the form: 


NAME OPERATION OPERAND 
A symbol IMPUR | None (ignored) 
(optional) 


The current LOC is saved and the new halfword boundary is set 
beyond the most recently used impure address. In 16-bit 
assemblies, this instruction has no effect if the program is 
already in relocatable mode. If it is in absolute mode, the LOC 
is switched to relocatable. 


NOTE 
Unless otherwise specified by the 
programmer, impure mode is assumed. 
3.6.6.3 Origin (ORG) Instruction | 


This instruction selects a LOC and sets it to a defined value. 
It has the form: 


NAME OPERATION OPERAND 
A symbol ORG A previously defined symbol 
(optional) Or expression 


The operand of the origin instruction determines which LOC is 
selected and the value it is given. If the value of the operand 
is pure relocatable, impure relocatable or absolute, the 
corresponding LOC is selected and set to the operand value. If 
the operand contains a forward reference, CAL/32 performs any 
additional passes required to define all symbols. 
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The user must guard against circular LOC dependency, as in the 
following example: 


ORG A 
LIS 4,4 

A EQU B 
LIS 4,4 

B EQU * 


END 


CAL/32 will flag an "M001 xxxTOP" error, where xxx is PURE, IMP, 
or ABS depending on the current LOC. 


NOTE 


If no ORG instruction appears at the 
beginning of a program, CAL/32 assumes it 
to be relocatable starting at relocatable 
zero, For 32-bit programs it also 
assumes the impure segment. 


3.6.6.4 Absolute (ABS) Instruction 


This instruction causes the LOC to be put in the absolute mode. 
It has the form: 


NAME OPERATION OPERAND 
A symbol ABS None (ignored) 
(optional) — | 


The current LOC is saved and the new LOC is set to point to the 
next halfword boundary beyond the most recently used absolute 
location. If the absolute LOC was not previously used, it is set 
to zero. 


3.6.6.5 Align (ALIGN) Instruction 


This instruction conditionally aligns the current LOC to the next 
highest value that is divisible by the specified operand. It has 
the form: 


NAME OPERATION OPERAND 
A symbol ALIGN A symbol or 
(optional) expression 
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The value contained in the operand field determines the type of 
alignment. Symbols used in the operand field must be previously 
defined. The value in the operand field must be absolute and 
equal to either 2, 4, 8, 16, etc. (power of 2). If the operand 
value is 2, CAL/32 adjusts the LOC to ensure that it contains a 
halfword address. CAL/32 forces fullword alignment if the 
operand value is 4 and doubleword alignment if the value is 8. 


If at the time of this instruction the LOC 
is already properly aligned, CAL/32 does not change it. If it 
is not properly aligned, CAL/32 increments it by the minimum 
amount necessary to force proper alignment. A symbol, if used in 
the name field, receives the value of the LOC after the alignment 
is performed. 


NOTE 


If the value of the operand is not 
absolute, or if it is not correctly 


defined, CAL/32 forces fullword 
alignment, and generates an error 
message, 


3.6.6.6 Conditional No Operation (CNOP) Instruction 


This instruction is similar to the ALIGN instruction in that it 
conditionally aligns the LOC to a power of 2. It has the form: 


NAME OPERATION OPERAND 
A symbol CNOP A symbol or 
(optional) expression 


The CNOP differs from the ALIGN instruction in that instead of 
merely incrementing the LOC, it actually inserts no operation 
instructions into the program stream. The value of the operand 
must be absolute and equal to a power of 2. Symbols used in the 
operand field must have been previously defined. If at the time 
this instruction is encountered, the LOC is on an odd boundary, 
CAL/32 increments it by one to make it even, inserts the required 
number of CNOP instructions to force alignment and generates an 
error message. This instruction has no effect if the LOC is 
already properly aligned. A symbol, if used in the name field, 
receives the value of the LOC associated with the first CNOP 
instruction generated. 
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3.6.7 Assembler Control Instructions 


These instructions allow the programmer to control the assembly 
process itself, identify the type of processor on which the 
program is to be run, temporarily halt the assembly operation, 
and request a limited amount of optimization. 


3.6.7.1 Target (TARGT) Instruction 


This instruction identifies the type of processor on which the 
program is to be run. It has the form: 


NAME OPERATION OPERAND 
A symbol TARGT A symbol or 
(optional) expression 


The value of the operand expression must be either 16 or 32, 
absolute. Symbols used in the operand field must be previously 
defined. If the operand value is 16, CAL/32 generates object 
code for 16-bit processors. If the value is 32, it generates 
object code for 32-bit processors. If the value is anything 
else, CAL/32 generates a warning message and generates code for 
the same type of processor on which it is running. If there is 
no TARGT instruction in the program, CAL/32 assumes the target 
machine to be the same as the machine on which the assembly is 
running. 


NOTE 
The TARGT instruction must precede any 


PURE or IMPUR instructions or any 
instruction that generates machine code. 


3.6.7.2 End (END) Instruction 


This instruction indicates the end of the source input. It has 
the form: 
NAME OPERATION OPERAND 
A symbol END A symbol or 
(optional) expression (optional) 
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Because of its function, this statement must be the last 
instruction in the source input file. The optional operand, if 
used, identifies the starting location of the program. For 
example: 


MAIN EQU ” 


LAST END MAIN 


The END instruction, with the operand MAIN, causes CAL/32 to 
output information identifying the location MAIN as the starting 
location of the program. The loader and the operating system use 
this information to ensure that the program starts at the 
requested location. If there is no operand, the END instruction 
merely terminates the assembly process without outputting any 
loader information. The END instruction is required in all 
CAL/32 programs. 


3.6.7.3 Copy Library (CLIB) Instruction 
This instruction allows the user to specify or change library 
files from within a program. It has the form: 


CLIB vol:filename.ext 


Each CLIB statement logically concatenates the new library file 
(operand of CLIB) to any existing library file. If the new 
library file cannot be assigned, CAL/32 will log an error message 
and pause, , 


3.6.7.4 Copy (COPY) Instruction 
This instruction allows the programmer to insert source code from 


library files into the source code received from the regular 
source input file. It has the form: 


NAME OPERATION OPERAND 
A symbol COPY A symbol.[,vol:fname. ext] 
(optional) (required) 


48-050 FOO RO3 3-57 


CAL/32 assumes that the library file was assigned to logical unit 
7 (lu7) (see Appendix A). CAL/32 also assumes that the file is 
made up of 80-character records. It searches through the logical 
file, looking only at the first ten characters of each record 
until it finds a file label of the form: 


RECORD POSITION CONTENTS 
1 and 2 ee 
3 through 10 A valid symbolic name of 


from 1 to 8 characters 


in which the symbolic name exactly matches the symbol in the 
operand field. If the search is unsuccessful, CAL/32 logs the 
message: 


COPY ERROR: XXXXXXXX 


in which xxxxxxxx is replaced by the name of the file being 
sought. This might happen in the case of incorrect file 
assignment. The operator can change the assignment and resume 
the assembly process from the location of the COPY instruction. 
The COPY instruction allows only one operand. The programmer 
must provide one COPY instruction for each file to be copied into 
the source stream. 


If the optional second operand is supplied, CAL/32 will assign 
and search only that physical file and ignore any files logically 
attached by CLIB. If the file cannot be assigned, CAL/32 will 
log an error message and pause, 


The copy process terminates when an END statement is encountered 
in the file, or when a record with either /* or /& in the first 
two character positions is encountered. Where an END instruction 
is encountered in the copy file, it does not mean the end of the 
source file but only the end of the copy file. At this point, 
CAL/32 resumes reading from the source input file. COPY 
instructions may not appear in files which are themselves being 
included in a source program by means of a COPY instruction. 


3.6.7.5 File Copy (FCOPY) Instruction 
The assembler instruction, FCOPY, allows the user to copy = an 


entire library file. It has the form: 


FCOPY vol:filename.ext 
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When FCOPY is in effect, a /* starting in column 1 or an END in 
the opcode field will be skipped, and copying will continue until 
an end of file is reached. If the file cannot be assigned, 
CAL/32 will log an error message and pause. 


3.6.7.6 Lower-Case (LCASE) Instruction 
This instruction allows the programmer to prevent the conversion 


of lower-case characters to their upper-case equivalents. This 
instruction applies to symbols only. 


NAME OPERATION OPERAND 
A symbol LCASE None (ignored) 
(optional) 


This option can be invoked as an instream operation or as a START 
option (see Section 5.2). When encountered, this instruction 
prevents the conversion of lower-case characters to their 
upper-case equivalents. If this option is invoked as a START 
option, all instream occurrences are ignored. 


3.6.7.7 No Lower-Case (NLCASE) Instruction 
This instruction allows the programmer to enable the conversion 


of lower-case characters to their upper-case equivalents. This 
is the default instruction. 


NAME OPERATION OPERAND 
A symbol NLCASE None (ignored) 
(optional) 


This option can be invoked as an instream operation or as a START 
option (see Section 5.2). When encountered, this instruction 
enables the conversion of lower-case characters to their 
upper-case equivalents, This instruction applies to _ symbols 
only. If this option is invoked as a START option, all instream 
occurrences are ignored, 


3.6.7.8 Pause (PAUSE) Instruction 


This instruction allows the programmer to halt the assembly 
process. It has the form: 


NAME OPERATION OPERAND 
A symbol PAUSE None (ignored) 
(optional) 
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The PAUSE instruction temporarily halts the assembly process. 
When the assembler encounters a PAUSE instruction, the assembler 
requests the operating system under which it is running to 
suspend execution. The system notifies the operator. The 
operator can resume execution of the assembler at the instruction 
immediately following the PAUSE instruction by using the 
operating system command CONTINUE, For example, the PAUSE 
instruction can be used by the operator to reassign a copy file, 
such as: 


COPY REGEQUS COPY REGISTER EQUATES 
PAUSE 
COPY COMBLKS COPY COMMON BLOCKS 


3.6.7.9 Squeeze (SQUEZ and NOSQZ) Instructions 
This instruction puts CAL/32 into squeeze or no-squeeze mode in 


which it performs a limited amount of space optimization. It has 
the form: 


NAME OPERATION OPERAND 
A symbol SQUEZ A symbol or expression 
(optional) (optional) 
A symbol NOSQZ Not used 
(optional) (ignored) 


The no-squeeze instruction (NOSQZ) has the effect of turning off 
the optimization processes initiated by a previous SQUEZ 
instruction. Optimization can be restarted by a subsequent 
squeeze statement. NOSQZ overrides a squeeze start option. 


When in optimization mode (SQUEZ), CAL/32 makes multiple passes 
over the source input. During each pass, it attempts to reduce 
long instructions (48 and 32 bits) to shorter forms (32 and 16 
bits). The value of the operand expressions sets the maximum 
number of passes. If CAL/32 can complete the optimization in 
fewer passes, it stops the optimization process and completes the 
assembly. 


The value of the operand expression must be an absolute number 
between 1 and 99. Any symbols used in the expression must have 
been previously defined. If the operand value is 0, or if there 
is no operand, CAL/32 assumes a maximum of nine passes. 
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NOTE 


Tf there are user-induced errors in the 
source stream (illegal mnemonics Or 
undefined symbols), CAL/32 terminates the 
squeeze operation and goes on to produce 
the final assembler output. Some 
instructions in this output may have been 
squeezed, depending on where in the 
process the errors were discovered. 


CAL/32 performs three types of space optimization: 


1. Changes RX3 instructions to RX2 or RXI1 


2. Changes operation codes to allow the use of an equivalent, 
but shorter, instruction | 


3. Eliminates unconditional branch instructions to the next 
halfword location 


An example of the first type of optimization is the forward 
reference instruction. In this instruction, the operand is 
defined in the program at some bPOENe beyond the instruction to 
which it refers. 


Example: 
A R1, VALUE 
VALUE DCF FYi25* 


When CAL/32 processes the ADD instruction, it cannot tell if the 
location of the second operand, identified by the symbol VALUE, 
is within the range of either an RX1 or RX2 instruction. It has 
to assume that an RX3 instruction is necessary. By making 
additional passes over the source input after all addresses have 
been resolved, CAL/32 has the needed information to determine if 
the reference to VALUE is within the range of either an RX1l or an 
RX2 instruction and make the substitution. 
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An example of the second type of optimization is: 
In the optimization mode, CAL/32 reduces this instruction to: 


LCS R3 ,1 


which reduces the length of the instruction from 48 bits to 16 
bits, without changing the effect. Depending on the processor, 
the substituted instruction might be faster or slower than the 
Original instruction, 


NOTE 


CAL/32 changes an operation code only in 
the object output. The Original 
instruction remains in the listing, 
flagged with an asterisk. 


The third type of optimization does not occur in normal 
programming, but it does sometimes appear in compiler-generated 


CAL/32. For example: 


ST R1,SAVE 
B CONTINUE 
CONTINUE L Rl, TEMP 


In this case, CAL/32 simply eliminates the unnecessary branch 
instruction, although the branch instruction does appear in the 
assembly listing, flagged with an asterisk. 


More than one SQUEZ instruction can appear in the program. The 
first SQUEZ instruction sets the number of additional passes. 
Subsequent SQUEZ instructions put CAL/32 back into optimization 
mode after a NOSQZ instruction took it out of the optimization 
mode. Operands may appear in the subsequent SQUEZ instructions, 


but they are ignored. 
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Because CAL/32 looks at only one instruction at a time, and 
because its global data is limited to the symbol table, squeezing 
might introduce errors into the program. This is most likely to 
happen when data and instructions are mixed. 


Example: 
BTC 8, LOOP1 
LOOP1 EQU * 
BFC 0, LOOP2 
DS 26 
ALIGN 4 
CONST DC F'256' 
LOOP2 EQU * 


If on one pass, CONST is already aligned on a fullword boundary, 
the branch to LOOP2 can be converted to a short format branch. 
A subsequent pass may allow the branch to LOOP1 to be shortened. 
When this happens, CONST is no longer on a fullword boundary, and 
CAL/32 adds two to the LOC to align it properly. This forces 
LOOP2 out of the range of a_ short branch instruction. CAL/32 
will recover from this situation by changing the branch 
instruction back to its original format and marking it internally 
as unsqueezable. 


3.6.7.10 Squeeze Related (ERSQZ and NORX3) Instructions 
There are two additional instructions that can be used to control 


squeezing and optimization of the source input file. They have 
the form: 


NAME OPERATION OPERAND 
A symbol ERSQZ Not used 
(optional) (ignored) 
A symbol NORX3 Not used 
(optional) (ignored) 
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The Error Squeeze instruction, (ERSQZ) can be used with the SQUEZ 
instruction. It forces CAL/32 to continue squeezing even after 
assembly errors are detected. 


The No RX3 instruction (NORX3) provides a simpler form of 
optimization during a normal 2-pass assembly. Once this 
instruction is encountered, CAL/32 forces RX instructions to the 
RX1 or RX2 format. RX3 instruction formats are still generated 
if double indexing is specified, or if the instruction references 
an element of a common block or an externally defined symbol. 
This instruction can be safely used in programs that are smaller 
than 16kb. It must not be used in segmented (pure and impure), 
programs. 


3.6.7.11 Sequence Checking (SQCHK and NOSEQ) Instructions 


The Sequence Checking instructions enable and disable the 
sequence checking of source. They have the form: 


NAME OPERATION OPERAND 
A symbol SQCHK Not used 
(optional) (ignored) 
A symbol NOSEQ Not used 
(optional) (ignored) 


The Sequence Check instruction (SQCHK) causes CAL/32 to compare 
each source statement sequence number with the number of the 
preceding statement. Each successive number must be greater in 
the ASCII collating sequence than the preceding one. CAL/32's 
initial sequence value is equal to eight spaces, so that numbers 
can be right-justified in the field without leading zeros. If a 
source statement contains a value equal to or less than the 
preceding statement, CAL/32 generates an error message. The 
sequence fields of statements included in the program by a COPY 
instruction are not checked. 


The No Sequence Check instruction (NOSEQ) disables the sequence 
checking process, The sequence field of this instruction is 
checked, if sequence checking was in effect at the time. The 
default mode of CAL/32 is NOSEQ. 


3.6.7.12 Scratch (SCRAT) Instruction 


This instruction causes CAL/32 to copy the source input file to 
a scratch device during pass one. It has the form: 


NAME OPERATION OPERAND 
A symbol SCRAT Not used 
(optional) (ignored) 
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Subsequent passes over the source input file are read from the 
scratch device, Since no statement preceding the SCRAT 
instruction can be copied, the SCRAT instruction should be the 
first statement in the program. . 


3.6.7.13 Pass Pause (PPAUS) Instruction 


This instruction causes CAL/32 to issue a pause request to the 
Operating system at the end of each pass. It has the form: 


NAME OPERATION OPERAND 
A symbol PPAUS Not used 
(ignored) (ignored) 


The purpose of the PPAUS instruction is to allow the operator to 
reset the source input file to the beginning for the next pass. 
This is useful in situations where no scratch file is available, 
and the source input file is not rewindable. 


NOTE 


Where neither the SCRAT instruction nor 
the PPAUS instruction is used, CAL/32 
issues a rewind command to the source 
input lu at the end of each pass. 


3.6.7.14 Message (MSG) Instruction 
This instruction allows the programmer to log a message to the 


system console or a multi-terminal monitor (MTM) terminal. It 
has the form: . 


NAME OPERATION OPERAND 
A symbol MSG Text 
(optional) 


The operand field contains the text of the message. All 
characters following the operation field, up to and including 
position 71, are sent to the system console as a message. This 
instruction can appear anywhere in the program, and the message 
is logged on every pass. 


3.6.7.15 Batch Assembly (BATCH and BEND) Instructions 


These instructions provide a means for assembling more than one 
complete program in a batch stream. They have the form: 
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NAME OPERATION OPERAND 


None BATCH Not used 
(illegal) (ignored) 
None BEND Not used 
(illegal) (ignored) 


The Batch instruction (BATCH) initiates the batch stream. It has 
the effect of redefining the END instruction so CAL/32 does not 
terminate itself at the end of the required number of passes. 
Rather, CAL/32 terminates the assembly of that particular 
program, reinitializes itself, and starts reading the next 
program from the source input file. The BATCH instruction must 
be the first statement in the stream of programs. If it is used, 
CAL/32 assumes that there is a scratch device. Options specified 
in the operating system START command remain in effect for the 
entire batch assembly (see Appendix A). 


The Batch End instruction (BEND) terminates the batch assembly. 
It must appear immediately following the END instruction in the 
last program of the stream. The BEND instruction tells CAL/32 to 
go to end of task when final assembly is completed. The end of 
task code returned is equal to the highest code generated during 
the batch assemblies. CAL/32 will also terminate a batch 
assembly normally if end of file or end of medium status is 
detected when attempting to read the first statement after the 
END of an assembly. 


3.6.7.16 Unreferenced Externals (UREX and NUREX) Instructions 
These instructions permit or suppress the output of object code 


for unreferenced externals. The default state is UREX. They 
have the form: 


NAME OPERATION OPERAND 
Not used UREX Not used 
(ignored) (ignored) 
Not used NUREX Not used 
(ignored) (ignored) 


3.6.7.17 Assembly Performance (HPM and NHPM) Instructions 


These instructions enable or disable the high performance method 
of source program assembly. 
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NAME OPERATION OPERAND 


Not used HPM Not used 
(ignored) (ignored) 
Not used NH PM Not used 
(ignored) (ignored) 


The HPM assembly process is automatically invoked by CAL/32 as 
the default setting. However, if insufficient memory workspace 
has been allocated when CAL/32 is loaded and memory is exhausted, 
assembly halts and recommences assembly from the beginning of the 
source file using the standard method of assembly. For further 
information concerning the HPM assembly process and memory 
workspace allocation, see Section 5.3.1. 


3.6.7.18 16-Bit Object Code (CAL and NOCAL) Instructions 


These instructions allow the assembly of a source program on a 
32-bit machine into either 16- or 32-bit format. NOCAL produces 
32-bit format while CAL produces 16-bit format. NOCAL is the 
default setting invoked by CAL/32 during assembly. 


NAME OPERATION OPERAND 
Not used CAL Not used 
(ignored) (ignored) 
Not used NOCAL Not used 
(ignored) (ignored) 


CAL/32 may not run aS a system task on a 16-bit machine, however, 
16-bit object code may be produced using the CAL instruction 
during assembly of the source code, 


3.6.8 Conditional Assembly Instructions 

These instructions allow the programmer to include code sequences 
in the program that may or may not be assembled, depending on 
some condition. By simply reassembling the program and 
redefining the conditions, a single program can be made to. serve 
more than one purpose. 


3.6.8.1 Compound Conditional (IFx, ELSE and ENDC) Instructions 


There are three instructions in this set. They have the form: 
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NAME OPERATION OPERAND 


A symbol IFx A symbol or 

(optional) expression 

A symbol ELSE A symbol or 

(optional) expression 
(ignored) 

A symbol ENDC A symbol or 

(optional) expression 
(ignored) 


The compound conditional instructions are used to provide 
complete conditional assembly capability. A symbol used in the 
name field of an IF instruction is defined if the condition 
described by the instruction is true. A symbol used in the name 
field of an ELSE instruction is defined if the corresponding IF 
condition is false. Symbols used in the name fields of end 
condition instructions are always defined. 


In the first instruction, the compound IF instruction, x 
represents the actual condition. Following is a list of the 
various mnemonics for these instructions: 


MNEMON IC MEANING MNEMONIC MEANING 
IFZ If zero IFNM Tf nonminus 
IFNZ If nonzero IFE If even 
IFP Tf plus IFO If odd 
IFNP If nonplus IFU If undefined 
IFM If minus IFD If defined 


CAL/32 tests the value of the operand when processing compound IF 
instructions. If the operand meets the condition specified by 
the operation, the instructions immediately following the IF 
instruction (until the corresponding ELSE or ENDC instruction) 
are assembled. If the operand does not meet the specified 
condition, the instructions immediately following the IF 
instruction are not assembled. 


The ELSE instruction reverses the state of the assembler as_ set 
by a previous compound IF statement. If the assembler was not 
assembling code because a previous IF statement turned off the 
assembly process, the appearance of an ELSE instruction would 
cause the assembler to resume assembling, starting with the 
instruction immediately following the ELSE instruction. I£ the 
assembler was assembling code because a previous IF condition was 
met, the appearance of the ELSE instruction would prevent’ the 
instructions immediately following the ELSE instruction (until 
the corresponding ENDC instruction) from being assembled. An 
ELSE instruction is not required to appear in ae block of 
conditionally assembled code. 
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The third instruction of this set is the End Condition 
instruction (ENDC) which terminates the presently active 
condition. Normal assembly process resumes with the next 
instruction. Any compound IF instruction used in the program 
must have a corresponding ENDC instruction. If the end of the 
source file is reached before an existing condition terminates, 
CAL/32 terminates the condition, generates an error message, and 
resumes normal assembly on the next pass. If the operand of the 
IFx contains a forward reference, CAL/32 will perform any 
additional passes required to define all symbols. As an example 
of conditional assembly, consider a subroutine that can receive 
its parameters in either of two ways: first, the parameters are 
located by referencing a list of addresses immediately following 
the branch and link instruction in the main program; second, the 
address of the actual parameter list is contained in register 14. 
The subroutine could handle both of these situations with 
conditional assembly, shown in the following example: 


Example: 

IFZ CALLI 

SUB LH R1,0 (RF) GET FIRST PARAMETER ADDRESS 
LH R1,0(R1) GET FIRST PARAMETER 
LH R2,2 (RF) GET SECOND PARAMETER ADDRESS 
LH R2,0(R2) GET SECOND PARAMETER 
AIS RF, 4 ADJUST RETURN ADDRESS 
ELSE -LIST NOT IN LINE 

SUB LH R1 , 0 (RE) GET FIRST PARAMETER 
LH R2,2 (RE) GET SECOND PARAMETER 
ENDC 

RETURN BR RF RETURN TO CALLER 


If, at assembly time, the value of CALL] is ZeLrO, the 
instructions between the IF instruction and the ELSE instruction 
are assembled and the instructions between the ELSE instruction 
and ENDC instruction are not assembled. If the value of CALL] is 
other than zero, only the instructions between the ELSE 
instruction and the ENDC instruction are assembled. 
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Another example of conditional assembly shows how conditions can 
be nested: 


IFNP LGTH CONDITION #1 
ERROR EQU 1 LGTH IS NOT POSITIVE 
ELSE CONDITION #1 
IFZ SRC-DST CONDITION #2 
ERROR EQU2 SRC IS EQUAL TO DST 
ELSE CONDITION #2 
LHI Rl, LGTH 
IFP SRC-DST CONDITION #3 


LHI R2,SRC 
LHI R3 ,DST 
ELSE CONDITION #3 
LHT R2,DST 
LHI R3 , SRC 


ENDC END CONDITION #3 
ENDC END CONDITION #2 
ENDC END CONDITION #1 


This set of nested conditionals depends on the values of three 
symbols: LGTH, SRC and DST. If LGTH is negative or zero, only 
the statement: 


ERROR EQU 1 LGTH IS NOT POSITIVE 


is assembled. If LGTH is positive, and SRC is equal to DST, only 
the second statement: 


ERROR EQU 2 SRC IS EQUAL TO DST 


is assembled. If LGTH is positive, and SRC is greater than DST, 
the following instructions: 


LHI Rl , LGTH 
LHI R2,SRC 
LHI R3 , DSC 


. 


are assembled. If LGTH is positive, and SRC is less than DST, 
the following instructions are assembled: 
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LHI Rl ,LGTH 
LHI R2,DST 
LHI R3 , SRC 


The user must be careful, when using a forward reference in the 
operand field of the IFU instruction, to avoid the following type 
of code: 


Oo KPwrY wr» 


CAL/32 will flag this code with an "MOO1l xxxTOP" error where xxx 
is PURE, IMP or ABS, depending upon the LOC used. 
NOTE 
A condition once set by an IF instruction 
remains in effect until the corresponding 
ENDC instruction is encountered. Thus, 
as in the next to the last example, when 
the first condition was met, the first 
statement was assembled. The ELSE 
instruction reversed this state, and no 
subsequent code was assembled. 
3.6.8.2 Simple If (IF) Instruction 
This instruction is retained in CAL/32 to maintain compatibility 
with previous assemblers. It has the form: 
NAME OPERATION OPERAND 
A symbol IF A symbol or 
(optional) expression 
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What CAL/32 does on encountering an IF instruction depends on the 
value of the operand. If the operand has a nonzero value, CAL/32 
assembles all statements following the IF instruction, until the 
end of the source file is reached, or until another IF 
instruction is encountered in which the operand value is zero. 
At this point, CAL/32 stops assembling the source input until the 
END instruction, or another IF instruction with a nonzero operand 
value, is encountered. If the operand contains a forward 
reference, CAL/32 will perform any additional passes required to 
define all symbols. 


NOTE 
Do not use simple IF instructions and 
compound IF instructions in the same 
program. Simple IF instructions must not 
be used in nested conditionals. 


3.6.8.3 Do (DO) Instruction 


This instruction provides a form of conditional and multiple 
assembly capability. It has the form: 


NAME OPERATION OPERAND 
A symbol DO A previously defined absolute symbol 
(optional) Or expression 


The DO instruction causes the statement immediately following it 
to be assembled as many times as specified by the value of the 
operand. The value of the operand must be between 0 and 32,767. 
If the value of the operand is 0, the next instruction is 
skipped. If the operand contains a forward reference, CAL/32 
will perform any additional passes required to define all 
symbols. 


The user must guard against. circular LOC dependency, as in the 
following example: 


A EQU * 
DO B-A 
DS 2 

B EQU be 
END 


CAL/32 will flag an "M001 xxxTOP" error, where xxx is PURE, IMP, 
or ABS, depending upon the current LOC, 
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3.6.9 Instructions for Data Structures 

These instructions allow the programmer to define complex data 
structures. Some of these instructions allow the programmer to 
define and initialize data blocks compatible with FORTRAN common. 


3.6.9.1 Structure Definition ion STRUC and ENDS) Instructions 


Structure definition instructions are used to define data 
Structures. They have the form: 


NAME OPERATION OPERAND 
A symbol COMN Not used 
(optional) (ignored) 
A symbol STRUC Not used 
(optional) (ignored) 
A symbol ENDS Not used 
(optional) (ignored) 


The Common instruction (COMN) defines FORTRAN-compatible common 
blocks. The Structure instruction (STRUC) defines other types of 
data structures. The End Structure instruction (ENDS) terminates 
both common definitions and data definitions. 


The symbol in the name field of a COMN or STRUC’ statement 
contains the absolute value of the length of the structure or 
common block. The symbol specified with the ENDS instruction is 
associated with the current value of the offset counter. 


A symbol is always required in the name field of a COMN 
instruction. To define FORTRAN compatible blank common, a 
special symbol consisting of two slashes (//) must appear in the 
first two positions of the name field. The remaining positions 
must be blank. If the name field is blank, CAL/32 will assume 
(//) was intended for a FORTRAN blank common. 


The scope of the common block consists of all the storage 
definitions between the COMN instruction itself and the next ENDS 
statement. Only define storage, origin, and equate instructions 
are permitted between a COMN and its corresponding ENDS 
instruction. The define storage instructions included within the 
common block definition do not actually reserve storage; they 
define offsets within the common block. Origin statements can be 
used to modify the offset counter. The equate instructions can 
be used to define symbols relative to elements in the common 
block. Common blocks cannot be nested within other common blocks 
or within other structure definitions. 


The following is an example of the definition of FORTRAN 
compatible common blocks: 
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C FORTRAN PROGRAM 
INTEGER*2 I,J,K,KK,K2,L 
COMMON A(10), I, J(3,20) 
COMMON/COMONE/B(30), K(4), KK 
COMMON/COMTWO/X,Y,2Z2,K2,L(24) 


The CAL/32 code to define these common blocks is: 


// COMN DEFINE BLANK COMMON 
A DS 40 TEN FLOATING POINT NUMBERS 
I DS 2 ONE TWO-BYTE INTEGER 
J DS 120 SIXTY TWO-BYTE INTEGERS 
ENDS END OF BLANK COMMON DEFINITION 
COMONE COMN DEFINE COMMON BLOCK COMONE 
B DS 120 THIRTY FLOATING POINT NUMBERS 
K DS 8 FOUR TWO-BYTE INTEGERS 
KK DS 2 ONE TWO-BYTE INTEGER 
ENDS END COMMON BLOCK COMONE 
COMTWO COMN DEFINE COMMON BLOCK COMTWO 
x DS 4 ONE FLOATING POINT NUMBER 
Y¥ DS 4 ONE FLOATING POINT NUMBER 
Z DS 4 ONE FLOATING POINT NUMBER 
K2 DS 2 ONE TWO-BYTE INTEGER 
L DS 48 TWENTY FOUR TWO-BYTE INTEGERS 
ENDS 


Common block definitions must precede any statements that 
reference the common block. Referencing a common element plus a 
displacement is permitted in the operand of a machine 
instruction, in a define constant instruction, or ina block data 
origin instruction defined below. 


STRUC is used to define general-purpose data structures, The 
scope of this data structure consists of all the storage 
definitions between the structure instruction and its 
corresponding ENDS instruction. Only define storage, origin and 
equate instructions can be used in a structure definition. The 
Gefine storage instructions do not actually reserve storage; they 
define offsets within the data structure. Origin statements can 
be used to modify the value of the offset counter. Equate 
statements can be used to define names relative to elements in 
the data structure. Data structures cannot be nested within 
other data structure definitions or within common block 
definitions. Within the scope of a STRUC or COMN definition, the 
value of the LOC is absolute and nonrelocatable. The LOC value 
is equivalent to the offset from the origin of the STRUC or COMN 
definition to the current location. 


To define a linked list structure, each node of which contains a 
2-byte forward pointer, a 2-byte backward pointer and a set of 
values such as four bytes, one byte, one byte and six bytes, the 
programmer might write: 
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NODE STRUC 


FWD DS 2 DEFINE FORWARD POINTER 

BAK DS 2 DEFINE BACKWARD POINTER 

VALA DS 4 DEFINE FOUR-BYTE VALUE 

VALB DS 1 DEFINE ONE~BYTE VALUE 

VALC DS 1 DEFINE ONE-BYTE VALUE 

VALD DS 6 DEFINE SIX-BYTE VALUE 
ENDS 


The effect of this definition is the same as: 


NODE EQU 16 
FWD EQU 0 
BAK EQU 2 
VALA EQU 4 
VALB EQU 8 
VALC EQU 9 
VALD EQU 10 


Once NODE is defined, it can be used as follows: 


LHI R5, POOL , GET ADDRESS OF POOL 

LB RO , VALB (R5) GET VALUE B OF FIRST NODE 

LH R5 , FWD (R5) GET POINTER TO NEXT NODE 
POOL DS 100*NODE 


Data structure definitions must precede any references to their 
elements in RX3 format instructions, unless the NORX3 instruction 
or the SQUEZ instruction was used. 


3.6.9.2 Structure Initialization (BDATA and BORG) Instructions 
Structure initialization instructions define FORTRAN compatible 


block data subprograms that consist of labeled common blocks. 
They have the form: 
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NAME OPERATION OPERAND 


A symbol  BDATA Not used (ignored) 
(optional) 

A symbol BORG Common block and element 
(optional) names, or offset 


The Block Data instruction (BDATA) must precede any statements 
that generate data, and the block data subprogram must not 
contain any executable code. The common blocks to be initialized 
must be defined at the beginning of the block data subprogram. 
Once they are defined, the Block Origin instruction (BORG) is 
used to initialize the data elements of the common blocks. The 
operand of the block origin instruction consists of the common 
block name followed immediately by the element name or its 
displacement enclosed in parentheses. Only one operand is 
allowed. Within the scope of the BDATA definition, the value of 
the LOC is an absolute, nonrelocatable value. The LOC value is 
offset from the origin to the current location. The BORG 
Statement sets the LOC to the value specified by the operand 
field. The following is an example of a block data subprogram. 


BDATA 
* 
* COMMON BLOCK DEFINITION 
* 
BLK COMN 
A DS 4 
B DS 40 
Y DS 20 
g DS 4 
ENDS 
* 
* INITIALIZE ELEMENTS A, B+8, AND Z 
* 
BORG BLK(A) REFERENCE BY NAME 
DC E'10! 
BORG BLK(64) REFERENCE BY DISPLACEMENT 
DC E'20! 
BORG BLK(B+8) REFERENCE BY NAME AND 
DISPLACEMENT 
DC E'30!' 
END 


This program initializes A to a floating point value of 10; Z to 
a floating point value of 20; and the third fullword of B toa 
floating point value of 30. 
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3.6.10 Listing Control Instructions 


These instructions allow the programmer to exercise some control 
over the format and the content of the source listing produced by 
CAL/32 on the final pass of the assembly. 


3.6.10.1 Listing Identification (PROG and TITLE) Instructions 
These instructions are used to force CAL/32 to print header 


information at the top of each page of the source listing. They 
have the form: 


NAME OPERATION OPERAND 
A symbol PROG Text 
(optional) 
A symbol TITLE Text 
(optional) 


The Program instruction (PROG) specifies the primary heading for 
each page of the listing. In addition, it causes the symbol in 
the name field to be placed at the beginning of the object file 
for program identification. On 16-bit assemblies, only the first 
six characters of the name field are put in the object file. 


All characters in the operand field (a maximum of 56), up to and 
including position 71, are printed in the primary header line of 
each page of the listing. If more than one PROG instruction is 
encountered in a module, the last PROG instruction will override 
all previous ones. 


The Title instruction (TITLE) is a way to specify subheadings 
that can be changed within the program. The text contained in 
the operand field, up to and including position 71, is printed on 
the line immediately below the heading produced by the PROG 
instruction, As many TITLE instructions as required can appear 
in the source input file. Fach time a TITLE instruction is 
encountered, CAL/32 starts a new listing page with the new 
subheading when the next printable statement is processed. 
Subsequent pages contain this same subheading, until another 
TITLE instruction appears. If two or more TITLE instructions 
occur together in sequence, only the last TITLE instruction 
affects the subheading content since a new page is printed only 
when a printable statement is encountered. TITLE instructions 
themselves are not printed although they are included in the 
statement count. 


3.6.10.2 Format Control (LCNT, EJECT, SPACE and WIDTH) 
Instructions 


These instructions allow the programmer to control the format of 
the listing. They have the form: 
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NAME OPERATION OPERAND 


A symbol LCNT A symbol or 
(optional) expression 
A symbol EJ ECT A symbol or 
(optional) expression 
A symbol SPACE A symbol or 
(optional) expression 
A symbol WIDTH A symbol or 
(optional) expression 


The operand field of the Line Count instruction (LCNT) specifies 
the number of lines to be printed on each page of the listing. 
The operand value must be an absolute number no greater than 99 
and no less than 10. The default value of the line count is 58. 


Whenever the Eject instruction (EJECT) appears, it overrides’ the 
specified or default line count, and causes CAL/32 to start a new 
page when the next printable statement is processed. The new 
page starts with whatever headings are in use. This statement is 
included in the statement count, but it is not printed. If one 
Or more EJECT instructions occur together in sequence, only one 
page is advanced since the actual advance occurs only when a 
printable instruction is encountered. EJECT instructions 
themselves are not printed although they are included in the 
statement count. 


The operand field of the Space instruction (SPACE) specifies the 
number of lines to be skipped in the listing. The value of the 
operand must be absolute. If the number of lines to be skipped 
exceeds the number of lines remaining on the page, this 
instruction has the same effect as an EJECT instruction and is 
included in the statement count, but not printed. 


The operand field of the Width instruction (WIDTH) specifies the 
number of columns’ to be printed across the page. The value of 
the operand field must be an absolute number, not greater’ than 
132 and not less than 64. The default value is 132. 

3.6.10.3 Content Control Instructions 


The content control instructions control the content of the 
listing. They have the form: 
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program. 


NAME OPERATION OPERAND 
A symbol NLIST Not used 
(optional) (ignored) 
A symbol LIST Not used 
(optional) (ignored) 
A symbol LSTC Not used 
(optional ) (ignored) 
A symbol NLSTC Not used 
(optional) (ignored) 
A symbol ERLST Not used 
(optional) (ignored) 
A symbol LSTM Not used 
(optional) (ignored) 
A symbol NLSTM Not used 
(optional) (ignored) 
A symbol FREZE Not used 
(optional ) (ignored) 
A symbol NFREZ Not used 
(optional) (ignored) 
A symbol CROSS Not used 
(optional) (ignored) 
A symbol NCROS Not used 
(optional) (ignored) 
A symbol LSTUR Not used 
(optional) (ignored) 
A symbol NLSTU Not used 
(optional) (ignored) 
A symbol WARN Not used 
(optional) (ignored) 
A symbol NWARN Not used 
(optional) (ignored) 
A symbol NPWRN Not used 
(optional) (ignored) 
A symbol PWRN Not used 
(optional) (ignored) 


NLIST 


option 


does 


The No List instruction (NLIST) suppresses listing of the 
Only those statements that contain errors are printed. 


Suppress MNOTE messages. 


messages are printed under all circumstances, 


reverses this situation, and all 
The assembler default is to print 


The List instruction (LIST) 
source statements are printed. 
all source statements. 


permits printing of 
This is the normal 


The List Conditionals instruction (LSTC) 
unassembled conditional assembly statements. 
default mode of the assembler. 


The No List Conditionals instruction (NLSTC) suppresses printing 
of unassembled conditional statements. 
48-050 FOO RO3 3-79 


The Error List instruction (ERLST) causes CAL/32 to print all 
assembly errors by type, along with the number of each statement 
on which the error occurred, immediately after symbol table 
listing. The default does not print this list. 


The List Macro instruction (LSTM) permits printing of all macro 
expansions that are part of the source input file. The macro 
instruction, the expanded source code, and the generated object 
code are printed. A plus character (+) precedes each statement 
number in the expanded source to identify those statements as 
part of a macro. This is the normal mode of the assembler. 


The No List Macro instruction (NLSTM) suppresses printing of 
macro expansions. Only the macro statement itself is printed. 
The NLSTM option does not suppress MNOTE messages. MNOTE 
messages will be printed under all circumstances. 


The Freeze instruction {(FREZE) halts incrementing of the 
statement counter when a copy file or macro expansion are 
included in the source input file. All statements in the copy 
file or macro expansion receive the same statement number as that 
of the COPY instruction. This is the normal mode of the 
assembler. 


The No Freeze instruction (NFREZ) increments the statement 
counter for every statement encountered in the source input. 


The Cross Reference instruction (CROSS) uses CAL/32 to generate 
and print a cross reference listing of all the symbols used in 
the program. Each symbol is listed in alphabetical order, along 
with identification of the statements in which it is referenced. 
The statement in which it is defined is flagged with an asterisk. 
This is the normal mode of the assembler. 


The No Cross instruction (NCROS) prevents the generation of a 
cross reference listing. 


The List Unreferenced Symbols instruction (LSTUR) causes 
unreferenced symbols to be listed in the symbol list. This is 
the normal mode of the assembler. 


The No List Unreferenced Symbols instruction (NLSTU) suppresses 
the listing of unreferenced symbols in the symbol list. 


The Warning instruction (WARN) allows CAL/32 to flag warnings in 
the listing and tally the number of warnings encountered. This 
is the normal mode of the assembler. 


The No Warning instruction (NWARN) suppresses both the warnings 
and the warning count from the listing. 


The No Processor Specific Warning instruction (NPWRN) suppresses 


the warning and the DCMD output generated for instructions not 
available on all processors. 
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The Processor Specific Warning instruction (PWRN) enables’ the 
warning and DCMD output upon encountering instructions not 
available on all processors. This is the default condition. 


3.6.11 Auxiliary Processing Unit (APU) and NAPU Options 


The APU and NAPU start options and the APU and NAPU_ pseudo 
instructions turn the APU option on or off. The APU and NAPU 
Start options override the corresponding APU and NAPU_ pseudo 
instructions. If more than one APU or NAPU option appears ina 
START option, the latest option takes precedence. The default 
for this option is off. 


Tf SVC, WCS or non-APU instructions are encountered when the APU 
option is on, their occurrences are flagged in the listing by the 
carat character (*) as CAL warnings which have no affect on the 
end of task code. When the APU option is in effect for each 
program containing SVC, WCS or non-APU instructions, CAL/32 
automatically generates and inserts one or more DCMD commands 
into the object code. The text of these DCMD commands is: 


*k*kK MODULE xxxx CONTAINS SVC INSTRUCTIONS 
**** MODULE xxxx CONTAINS WCS INSTRUCTIONS 
**k*k* MODULE xxxx CONTAINS INSTRUCTIONS ILLEGAL FOR APU 


Where: 
XXXX represents the name of the program. 


3.7 ASSEMBLY LISTING 


The assembly listing consists of two sections: the source and 
object program statements and the symbol cross-reference table. 
The format for printing the source and object program statements 
is basically the same for either 16-bit assemblies or 32-bit 
assemblies. The only difference is in the number of characters 
printed for the LOC and the object data. 


e In 16-bit assemblies, only four hexadecimal digits are printed 
for the LOC and a maximum of eight hexadecimal digits for the 
data. The letter R is appended to the LOC value if the 
relocatable LOC is being used. 


e In 32-bit assemblies, six hexadecimal digits are printed for 
the LOC and a maximum of 12 hexadecimal digits for the object 
data. In addition, the actual second operand address of RX2 
and SF instructions is printed next to the object data. This 
address is preceded by an equal sign (=). The letter I is 
appended to the LOC if the impure LOC is being used. The 
letter P is appended to the LOC if the pure LOC is being used. 
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@e In both 16- and 32-bit assemblies, the letter F is appended to 
the data field to indicate that the statement references an 
externally defined symbol, a symbol in a common block or an 
undefined symbol. 


The statement number is a decimal number between 1 and 99,999. 
Each source statement read by the assembler is assigned a 
unique statement number, beginning with 1, except for source 
statements from a copy file or macro expansion with the FREZE 
instruction. The first column of the listing can contain any 
of the following characters; 


CHARACTER MEAN ING 
! The name field of this instruction contains a 
symbol that was redefined by an EQUATE 
instruction. 
? A machine instruction not available on the 


target machine was used; an operand that was 
improper existed and was substituted, or 


a machine dependent instruction was used in 
assembling a common but could be assembled, or 


an assembler instruction was used with an 
operand that was improper but could be 
assembled, or 


a SCRAT card was encountered as other than the 
first statement or when batch mode is in 
effect, or 


an EXTRN/ENTRY symbol is longer than _ six 
characters for target 16, or 


a DS instruction was encountered in a pure 
section. 


* A machine instruction was shortened or 
modified by squeezing. 


- The APU option is in effect, and the 
instruction on this line is a Supervisor Call 
(SVC) instruction, a Writable Control Store 
(WCS) instruction, or an instruction illegal 
for an APU. 


# The instruction used is not valid on all 
processors. 


The following information is printed at the beginning of the 
cross reference listing: 
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@e Start options in the START command. 


e The number of errors detected by the macro processor if the 
program assembled was generated by the macro processor. 


@e Number of CAL/32 errors and the page number of the last error 


@e Number of CAL/32 warnings and the page number of the last 
warning 


@e Number of passes 
@e Message indicating the use of symbol table paging to disk 


@e Message indicating abnormal termination of squeezing because 
of squeeze-induced errors 


@e Message indicating the amount of required table space 


Following this, each symbol used in the program is listed in 
alphabetical order along with its value. If a cross reference 
was requested, the statement number of each statement containing 
a reference to the symbol is printed following the value. The 
statement number in which the symbol is defined is printed with 
an asterisk (*) following. Associated with each symbol is a flag 
used to indicate one of the following: 


FLAG MEANING 

b Properly defined local symbol 
M Multiply defined symbol 

U Undefined symbol 

< Entry symbol _ 

<U Undefined entry 

> Externally defined symbol 

>M Multiply defined external 

*% Unreferenced external 


The flag is printed in the first column of the line containing 
the symbol. 


If an error is detected in a source statement, the following 
message is printed immediately after the error statement: 


** Annn ** 


A indicates the general type of error, and nnn is a decimal 
number that further identifies the error. Appendix A contains a 
complete list of CAL/32 error codes. 
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CHAPTER 4 
COMMON MODE PROGRAMMING 


4.1 INTRODUCTION 


A useful feature of Common Assembly Language/32 (CAL/32) is 
common mode programming where a Single source file can be used to 
produce object code for either 16- or 32-bit processors. In 
creating a common mode source file, the programmer must be aware 
of certain restrictions and safeguards and, in some cases, must 
use special operation mnemonics that can be translated into 
either 16- or 32-bit operations. 


4.2 ADDRESS OPERATION INSTRUCTIONS 


Addresses for 16-bit processors occupy 16 bits, a halfword. For 
the 32-bit processors, addresses occupy the least significant 24 
bits of a fullword. In normal mode, CAL/32 makes no distinction 
between operations on address quantities and operations on other 
data types. However, when writing in common mode, the programmer 
must use special operation mnemonics for address operations’ so 
CAL/32 can translate them into the correct target machine code. 
Table 4-1 lists these instructions, their mnemonics and the 
target machine translations. 


TABLE 4-1 COMMON MODE ADDRESS OPERATIONS 


ve gee ORS Ay en Oe OS ey OEE ee Oe ee ee ee ey ee eee GE Os OT Gee Go ae Gee fey eee OF ee ee ee me Ge eS eet Oe eS ee ee OE ee ee ee ee oe gee mt et oe ee es ee 


| 
| TRANS- | TRANS- | 
| 


INSTRUCTION | MNEMONIC | LATION | LATION 
sarmasnasness ese sse eee e ese er ses sesessssessssersesneseese|s | 
Add address AA A AH 
Add address immediate AAT AI AHI 


| | | | 
| | | | 
Add address RR ] AAR | AR | AHR | 
| | | | 
| | | | 


Add address to memory AAM AM AHM 

Compare address CA C CH | 
Compare address immediate | CAI | CI | CHI | 
Compare address RR CAR | CR | CHR | 
Compare logical address | CLA | CL | CLH 
Compare logical address | | | | 
immediate | CLAI | CLI | CLHI | 
Compare logical address RR | CLAR | CLR | CLHR | 
Immediate | CLAI | CLI | CLHI | 
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TABLE 4-1 COMMON MODE ADDRESS OPERATIONS (Continued) 


en Ghee Mae Gee Gee STS Sen GENE EWS CTS Ge STE es Ge ST Ge ae ek GW ae ED Gs Oe Ore Se Oe Gee SE GE OE SE Oe OF OE me SE ee ee eee Om ee ne ee OM ee ee OO er ee See OEE one ee ane om ame 


| | | 32-BIT | 16-BIT | 
| | | TRANS- | TRANS-— | 
| 


INSTRUCTION | MNEMONIC | LATION | LATION 
| SS SS a ee ee rn ee ee See ee ee ee eee oe mae met ome ice Grr Ome Gen Gar came Sue ae aan Sta ane Oe ane one eee ane Se Get Set aA San aoe Se Se ST at ee Oe ae ee Se a a on om ae | 
Load address LDA L LH 
Load address immediate LDAI LA LHI 


| | | | 
| | | | 
| Load address RR | LDAR | LR | LHR 
| | | 
| | | | 


AND address NA N NH 

AND address immediate NAI NI NHI 
| --------- ----- = === === 3 nnn nn nn nnn nnn nnn ne nn nnn nena | 
| AND address RR | NAR | NR | NHR 
| OR address | OA | Oo | OH | 
| OR address immediate | OAI | OT | OHI 
| OR address RR | OAR | OR | .OHR | 
| Subtract address | SA | § | SH | 
| ------------------------------------- +--+ == 2-2 - == == === | 

Subtract address immediate SAI SI SHI 

Subtract address RR SAR SR SHR 


| | | | | 
| | | 
| Shift left address arithmetic | SLAA | SLA | SLHA | 
| | | | | 
| | | | | 


Shift left address logical SLAL SLL SLHL 
Shift right address arithmetic SRAA SRA SRHA 

| ------- =~ nn nn nn nnn nnn nn nnn nn nnn nnn enn nnn | 
Shift cight address logical SRAL SRL SRHL 
Store address STA ST STH 


| | | | | 
| | | | | 
| Test address immediate | TAT | TTI | THI | 
| | | | | 
| | | | | 


Exclusive OR address XA x XH 
Exclusive OR address immediate XAI XI XHI 

| -------~------ ~~ -- ~~ 2 ne enn nn nn ne ne ene | 
Exclusive OR address RR XAR XR XHR 
Multiply address MA M MH 


Divide address 
Divide address RR 


ees ee ee we Ee Se ey ee ae Se Ge es ae ee Ge ee ow ams ee a et OO Om ae GT EF O88 ee © Oe ae Om eee OE ewe am OEE Ge ee Ot OM mt om es ee mt Gre Gee ot Gs Oe a a em ee 


| | | | | 
| | | | | 
| Multiply address RR | MAR | MR | MHR | 
| | | | | 
| | | | | 


CAL/32 translates these instructions into halfword or fullword 
instructions, depending on the target machine. For example: 


LDA R1,ADD1 
AA R1,DISP 


ADD1 DC A (TABLE) 
DISP DC 2 
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When CAL/32 assembles these instructions for 16-bit execution, it 
produces object code that would normally correspond to: 


LH R1,ADD1 
AH R1,DISP 


e 


For 32-bit programs, CAL/32 produces code that would correspond 
tos: 


R1,ADD1 
R1,DISP 


i fle ¢ e 


Translation is at the object code level; CAL/32 prints’ the 
original common mode code on the listing. 


4.3 COMMON MODE IMMEDIATE OPERATIONS 


CAL/32 provides a common mode immediate operation for the load 
immediate LDI instruction. Depending on the target machine, the 
LDI is translated into a fullword-referencing LI instruction for 
the 32-bit machine, or a halfword-referencing LHI instruction for 
the 16-bit machine, as follows: 


COMMON 32-BIT 16-BIT 
INSTRUCTION MNEMONIC TRANSLATION TRANSLATION 
Load Immediate LDI LI LHI 


4.4 COMMON MODE ASSEMBLER INSTRUCTIONS 


In addition to all of the regular assembler instructions 
described in Chapter 3, CAL/32 recognizes four assembler 
instructions primarily for use in common mode programming. Two 
of these are data definition type instructions; the other two are 
assembler control type instructions. 
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4.4.1 Data Definition Instructions 


The common mode data definition instructions are: Define Address 
Length Constant and Define Address Length Storage. They have the 
form: 


NAME OPERATION OPERAND 
A symbol DAC One or more operands 
(optional) separated by commas 
A symbol DAS A symbol or expression 
(optional) 


4.4.1.1 Define Address Length Constant (DAC) Instruction 


The DAC constant instruction is equivalent to the Define Constant 
instruction. It is used in common mode programming to reserve 
storage to be initialized with address length constants. For 
32-bit assemblies, the constants are fullwords aligned on 
fullword boundaries. For 16-bit assemblies, the constants are 
halfwords aligned on halfword boundaries. 


4.4.1.2 Define Address Length Storage (DAS) Instruction 


The DAS instruction is equivalent to the Define Storage 
instruction. In 32-bit assemblies, the instruction reserves the 
specified amount of fullwords aligned on a fullword boundary. In 
16-bit assemblies, it reserves the specified amount of halfwords 
aligned on a halfword boundary. Examples of the use of these 
instructions are: 


DAC A( TABLE) 
DAS 16 


When assembled for 32-bit execution, the DAC instruction 
generates a fullword containing the address of TABLE. The DAS 
instruction reserves 16 fullwords of storage. When assembled for 
16-bit execution, these instructions cause CAL/32 to generate a 
halfword containing the address of TABLE, along with a storage 
area of 16 halfwords. 
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NOTE 
DAS instructions can be used in common 
block and structure definitions. 
4.4.2 Assembler Control (CAL and NOCAL) Instructions 


TwO special assembler instructions control error checking. Their 
form is: 


NAME OPERATION OPERAND 
A. symbol CAL Not used 
(optional) (ignored) 
A symbol NOCAL Not used 
(optional) (ignored) 


The first of these instructions, CAL, establishes the common mode 
and enables common mode error. checking. In this mode, any 
machine-~dependent instruction causes a nonfatal error anda 
warning flag is printed on the assembly listing. 


The NOCAL instruction disables the common mode and its error 
checking mechanisms until the next CAL instruction is 
encountered. This is the assembler default mode in which an 
operation code mnemonic, not valid for the targeted processor but 
for which there is a valid equivalent, is assembled using the 
valid equivalent. A question mark (?) is then printed in the 
left hand margin of the listing. 


4.5 MIXED MODE COMPUTATIONS 


On 32-bit processors, mixed mode computations, such as adding a 
halfword quantity to an address length quantity contained ina 
register, can be performed. In general, any halfword arithmetic 
Or logical operation can be performed on address’ length 


quantities contained in registers. The exceptions are: shifts, 
multiply and divide. The halfword forms of these instructions 
should never be used with address length quantities. Instead, 


use the special address operation instructions. 
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4.6 GLOBAL SYMBOLS 


The global symbols, ADC and LADC, are used primarily in common 
mode programming. In 32-bit assemblies, ADC has a value of four, 
the length in bytes of an address length constant. LADC has a 
value of two, the log (base 2) of the address length. In 16-bit 
assemblies, ADC has a value of two and LADC has a value of one. 
Tllustrated are these symbol uses in which a main program calls 
a subroutine and passes parameters to the subroutine in a list of 
addresses immediately following the branch and link instruction: 


BAL RF, SUB 
DAC A(PARM1) ,A(PARM2) ,A(PARM3) 
RETURN EQU = 


The subroutine picks up the parameters and calculates the return 
address as follows: 


SUB AIs RF, LADC ADJUST RF FOR 
NAI RF,-ADC ALIGNMENT 
LDA R1,0 (REF) ADDRESS OF FIRST PARAMETER 
LDA R2, ADC (RF) ADDRESS OF SECOND PARAMETER 
LDA R3 ,2* ADC (RF) ADDRESS OF THIRD PARAMETER 
SUBEND B 3 *ADC (RF) RETURN TO CALLER 


The Add Immediate Short instruction and the And Address Immediate 
instruction are needed in the subroutine because alignment of 
address constants in 32-bit assemblies can cause a halfword of 
filler to be inserted between the branch and link instruction and 
the first address constant. In this case, the address in 
register 15 is the address of this halfword, and these 
instructions increment the address in register 15 to make it 
point to the first address constant. If no filler is required, 
because the first constant is naturally aligned on a fullword 
boundary, register 15 points to the first constant and these two 
instructions have no effect. 
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Another use of LADC is in shift instructions where a byte pointer 
must be converted into an address pointer, as: 


LB R1 , INDEX GET BYTE POINTER 

SLAL R1,LADC CONVERT TO ADDRESS POINTER 
LDA R2,TABLE(R1) GET ADDRESS FROM TABLE 

BR R2 


In 16-bit assemblies, LADC has a value of one and the Shift Left 
Logical instruction has the effect of doubling the value of the 
byte pointer, converting it into a halfword pointer. In 32-bit 
assemblies, LADC has a value of two, and the Shift instruction 
has the effect of quadrupling the value of the byte pointer, 
converting it into a fullword pointer. 


The LADC symbol can also be used where machine dependent code 
must be written within a common mode program. For example: 


IFNZ LADC-1 IF NOT ZERO USE 32 BIT CODE 
L RF,A LOAD FULLWORD IN RF 

A RF,B ADD FULLWORD B 

ST RF,A STORE INA 

ELSE LADC-1 IS ZERO USE 16 BIT 
LM RE,A LOAD FULLWORD IN RE AND RF 
AH RF, B+2 ADD LOW ORDER B 

ACH RE,B ADD HIGH ORDER B 

STM RE,A STORE IN A 

ENDC 


shows how fullword addition, requiring double registers in 16-bit 
assemblies and single registers in 32-bit assemblies, can be 
handled in a common mode program. 
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4.7 SPECIAL INSTRUCTIONS 


By definition, the instructions Load Multiple, Store Multiple, 
and Load PSW, operate on address length data. This is why there 
are no address operation mnemonics for these instructions. Where 
these instructions are used in common mode programming, the data 
on which they operate must be defined by the Define Address 
Length Constant (DAC) and the Define Address Length Storage (DAS) 
instructions. For example: 


LPSW NEWPSW 


START STM RO, SAVE 
LM RO, PARAM 


NEW PSW DAC STATUS, A( START) 
RSAVE DAS 16 
PARAM DAC CON1,CON2,... 


List processing instructions operate on address length quantities 
within the list. There is some incompatibility between the 16- 
and the 32-bit versions of these instructions. The 16-bit list 
instructions require byte pointers at the head of the list. The 
32-bit list instructions require halfword pointers. List 
instructions can be used in common mode programming as long as 
the number of slots in the list does not exceed 255. 
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Lists always should be defined with the Define List instruction. 
Use byte instructions where it is necessary to refer to the list 
pointers in the program. Define displacement into the list 
pointer fields in terms of the LADC symbol. For example: 


SLOTS EOU  LADC~1 NUMBER OF SLOTS 
USED ROU 2*LADC-1 NUMBER USED 
CTOP FOU 3*LADC-1 CURRENT TOP 
NBOT FOU 4*LADC-1 NEXT BOTTOM 

LB R1, LIST+CTOP 
LISt DLIST 32 


In this example, the Load Byte instruction is used along with the 
value of CTOP to access the current top pointer in the list. 
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| CHAPTER 5 
COMMON ASSEMBLY LANGUAGE/32 
(CAL/32) OPERATING INSTRUCTIONS 


5.1 INTRODUCTION 


The CAL/32 assembler is utilized to assemble a_ user-created 
source file, thus producing a machine language object file. The 
object code, once successfully assembled and linked, may be 
executed by the user. | 


CAL/32 is loaded and started directly from a user terminal with 
various START options available. The START options permit a user 
to tailor the assembled output in the desired manner. This 
chapter directs the user through the assembler process, including 
the assignment of logical units; allocating memory workspace; 
specifying START options; and the creation of a command 
substitution system (CSS) to load and start CAL/32. Also 
included in this chapter is a section designed to direct the 
tae. administrator on how to establish CAL/32 as a task under 
0S/32. 


5.2 OPERATING INSTRUCTIONS FOR ESTABLISHING COMMON ASSEMBLY 
LANGUAGE/32 (CAL/32) AS A TASK 


If CAL/32 has not been established as a task under 08/32, the 
relocatable object code supplied for CAL/32 must be linked as an 
Operating system task. This procedure may only be performed from 
a system console. The following command sequence is ae typical 
process for establishing CAL/32 as a task using OS/32 LINK: 


LO .BG,LINK 

T BG 

st 

>ES TA 

>OP WORK=(X30000,XE0000) ,SYS=X7FFFFF, SEG, ROL 
>IN CAL32 

>BU CAL32 

>END 


CAL/32 is segmented into pure and impure code for shared use with 
operating systems that support this capability. To establish 
CAL/32 as a nonsharable task, remove the SEG option from the 
above command sequence. 
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When assembly is completed, CAL/32 terminates through the 
operating system, which logs this message: 


END OF TASK n 


Where: 


n specifies the end of task code. 


An EOT code other than 0 or 1, indicates that CAL/32 was not 
successfully linked and did not produce a usable task image. See 
the OS/32 Link Reference Manual for further details concerning 
linking object modules to produce task images under OS/32. 
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5.3 COMMON ASSEMBLY LANGUAGE/32 (CAL/32) START OPTIONS 


When operating under 08/32, CAL/32 accepts 
options as arguments of the START command. 


override assembler instructions and cause a carat (%*) 
in the first line of the listing. Any combination of spaces 
and/or commas can separate or follow the options specification: 


Formats: 


one, Hl = i BATCH] \ 


[ERLIST] [ERSQZ] 
NL 


[LCNT= 10-99] 


| 


[pPausE] 


Options: 


APU 


NAPU 
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= 


sa i Cecrat! 


1 ee 


| 


| [np1sc] [wrrx] [Norxt] [NoRx3] 


turns on auxiliary processing 
warnings. 


turns off APU warnings. 
setting for this option. 


This is 


certain 
The start options 


to 


unit 


the 


control 


appear 


1 


(APU) 


default 


BATCH 


CAL 


NOCAL 


CROSS 


NCROS 


DEL 


NDEL 


ERLST 


ERSQZ 


FREZE 


NFREZ 


HPM 


NH PM 


LCASE 


initiates a batch stream to allow the assembly 
of more than one program. See Section 
3.6.7.15 for further details. 


assembles a source program to run on a 16-bit 
machine. 


assembles a source program to run on a 32-bit 
machine. This is the default setting. 


generates a cross reference listing of all 
symbols used in a source program. 


prevents the generation of a cross reference 
listing. 


deletes and reallocates object and listing 
files as required during CAL/32 assembly. 
This option deletes and reallocates logical 
unit 2 (lu2) and lu3 (both previously 
unassigned), and assigns them to fd.OBJ and 
fd.LST, respectively. 


returns an 8100 error if fd.OBJ and fd.LST 
have not been allocated and assigned to lu2 
and 1u3, respectively. This is the default 
setting. 


prints all assembly errors by type and the 
statement number where the error was 
encountered. 


controls squeezing and optimization of the 
source file by continuing the squeeze process 
after assembly errors are detected. 


halts the incrementation of the statement 
counter when a copy file or macro expansion is 
included in the source file. This is the 
default setting. 


increments the statement counter for each 
statement encountered in the source file. 


enables the high performance method of 
assembly. This is the default setting. See 
Section 5.3.1 for further details concerning 
HPM assembly. 


disables the high performance method of 
assembly and assembles the source program 
using the standard method. 


prevents the conversion of lower-case 
characters to their upper-case equivalents. 
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NLCASE 


LCNT 


LIST 


NLIST 
LSTC 
NLSTC 


LSTM 


NLSTM 
LSTUR 
NLSTU 


NDISC 


NFIX 


NORX3 


NORXT 


PPAUS 


PWRN 


NPWRN 
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enables the conversion of lower-case 
characters to their upper-case equivalents. 


specifies the number of lines to be printed on 
each page of the listing. The number of lines 
printed per page may be no less than 10 and no 
More than 99. 


prints all source program statements to the 
program listings. This is the default 
sequence. 


Suppresses the listing of all source program 
statements. 


permits the listing of unassembled conditional 
assembly statments. 

suppresses the listing of unassembled 
conditional assembly statements. 


permits the listing of all macro expansions 
contained in the source program. This is the 
normal mode of the CAL/32 assembler. 


suppresses the listing of all macro expansions 
contained in the source program. 


lists unreferenced symbols in the symbol 
table. This is the default setting. 


suppresses the listing of unreferenced symbols 
in the symbol table. 


disables symbol table paging to disk. 


prevents CAL/32 from making extra passes’ to 
correct squeeze induced errors. 


provides a simple optimization during a normal 
two-pass assembly. CAL/32 forces RX 
instructions to either RX1l or RX2 format. 


is an alias for NORX3. 


issues a pause request to the operating system 
at the end of each pass. 


enables the warning and DCMD output generated 
for instructions not available on all 
processors. This is the default setting. 


disables the warning and DCMD output generated 
for instructions not available on all 
processors. 


SCRAT copies the source file to a scratch device 
during the first pass. Subsequent passes of 
the source file are read from the scratch 
device. 


SQ CHK compares each source statement sequence number 
with the number of the preceding statement. 


NOSEQ disables the source statement sequence number 
checking process. 


SQUEZ performs a limited amount of space 
optimization of the source file during 
assembly. 

NOSQ2Z disables the optimization processes of the 
SQUEZ option. 

TARGT identifies the processor type on which the 
program is to be run, If the value 16 is | 
targeted, CAL/32 generates object code for a 
16-bit processor. If the value 32 is 


targeted, CAL/32 generates object code for a 
32-bit processor. 


UREX outputs object code for unreferenced 
externals. This is the default setting. 


NUREX Suppresses the output of object code for 
unreferenced externals. 


WARN flags warnings in the listing and outputs’ the 
warning messages and the total number of 
warnings encountered during assembly. This is 
the default setting. 


NWARN Suppresses both warning messages’ and the 
warning count from the listing. 


WIDTH specifies the number of columns to be printed 
across the page. 


Functional Details: 


A typical start command for a CAL/32 assembly with start options 
is: 


ST ,DEL, SQUEZ=99,NCROS 


When CAL/32 encounters conflicting start options such as _ CROSS 
and NCROS, it will regard the last option encountered as the 
intended option. This allows the user to redefine the default 
Start options via CSS. See Section 5.3.2 for further details 
pertaining to the redefinition of CAL/32 START options within a 
CSS. 
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5.3.1 High Performance Method (HPM) Assembly 


CAL/32 is equipped with a START option that assembles a_ source 
program faster than the standard method of assembly. The HPM 
option is automatically invoked by CAL/32 as a default setting. 
See Section 5.3 for START option command conventions. If 
insufficient memory space is allocated, CAL/32 halts the assembly 
process using the HPM option and restarts assembly using the 
standard method. The following message is displayed to the 
terminal if insufficient memory is allocated for the HPM option: 


Table space exceeded - defaulting to the standard method. 


The HPM option may be disabled prior to source program assembly 
by specifying the NHPM option in the START command. This 
prevents CAL/32 from invoking the HPM option. This option is 
desirable for installations with insufficient memory overhead to 
assemble using the HPM option or for the assembly of programs 
that consistently exceed memory allocation. 


CAL/32 reports the minimum memory expansion workspace necessary 
to assemble a source program using the HPM option. This feature 
is beneficial to maximize memory allocation for future assembly 
of the same source program. If too much memory is allocated upon 
initial assembly, future allocation of memory may be tailored to 
efficiently assemble the source program and maximize system 
resources, The formula needed to determine the amount of memory 
Space required to assemble a source program using HPM is depicted 
in Table 5-1. 


TABLE 5-1 MEMORY REQUIREMENTS FOR HPM 


| ASSEMBLY | PROGRAM ASSEMBLY | ADDITIONAL MEMORY | 

| METHOD | (GENERATING SYMBOL TABLE) | FOR CROSS-REFERENCE | 

| SSS SSS SSS SS VSS SV SVS SS SSS SS SSS SS SS SSS SSS SSS SS SS SS SSS SSS SS SSS SSS SSS SS SE STS SS 
Standard | 28 bytes/symbol 2 512-byte buffers for symbols 


1 256-byte buffer for bit map 


44 bytes/symbol 8 bytes/symbol (at most 2 


bits/symbol for bit map) 


| | 
| | 
| | 
| Faster | 
| 


In order for CAL/32 to successfully utilize the HPM option, 
sufficient memory overhead is’ required. Table 5-2 shows the 
increased memory requirements necessary for HPM. 
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TABLE 5-2 HPM MEMORY UTILIZATION 


| NUMBER OF SYMBOLS | NUMBER OF BYTES USED | NUMBER OF BYTES USED | %INCREASE | 
| IN A PROGRAM | IN STANDARD METHOD | IN FASTER METHOD | OF MEMORY | 
| 500 12,768 | 26,250 | 78 | 
| 1000 | 28,768 | 52,250 | 82 | 
| 2000 | 56,768 | 104,500 | 84 | 
| 3000 | 84,768 | 156,750 | 85 | 
| 5000 | 140,768 | 261,250 | 86 | 
| 10,000 | 280,768 | 522,500 | 86 | 

20,000 | 420,768 | 783,750 | 86 | 
CAL/32 processor time for the standard and faster modes of 
assembly are relatively equal; however, the HPM option 
considerably reduces input/output (I/0) time during assembly. 
Table 5-3 shows CAL/32 assembly performance improvement for the 
high performance method as compared to the standard method of 
assembly. The source programs utilized for this comparison 


varied in source statement content to best test the 
The amount of performance improvement is 
number of symbols utilized in the source program 
times each symbol is referenced. 


HPM option. 
dependent upon the 
and number of 


TABLE 5-3 ASSEMBLY PERFORMANCE IMPROVEMENT USING HPM 


ae ee oe GD SED GN SE GE GNP En GED SES QS GE Gene EE SY Gee, GE Ge oe SUE ES Ge aes eee eee SES Get es ey ET OE Gye GET OD OE OE Ge Se oe Oe Oe ee OS Om OF Oe me me re oe Ot oe ee one Ge OR Se ee ee et ee en oe ee ee en 


estat actuelle oe setae tna etal | ELAPSED TIME | ELAPSED TIME | % REDUCTION 
| # OF LINES | # OF ‘SYMBOLS | STANDARD METHOD | FASTER METHOD | IN TIME 


] SSS SS SS SSS SHS SSSSS SSS SSSR SBSSSBASITERASBSEBSSSSBSSSELS SSS SSSSSASASALKGKRSBARSSSSSTES SSS 


fo] 


| 214 | 250 | 0:35 | 0:11 | 68 

1023 | 181 | 1:05 | 1:04 | 

| 43 86 | 6 43 5:24 | 3:49 | 29 

| 7023 2200 11:00 | 3344 | 66 

|} 12487 | 3606 | 15:20 | 7:20 | 52 

| 18568 | 2683 | 21:31 | 8:35 | 60 
NOTE 


To maximize CAL/32 performance efficiency 
when expanding using MACRO/32, a record 
length of 800 should be specified for the 
-CAL file. 
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§.3.2 Assigning Logical Units 


The CAL/32 assembler requires a minimum of one lu and up to a 
maximum of 11 logical units for operation, depending on the 
options selected and the features invoked by the source program. 
All of these logical units can be assigned by the user. However, 
if an lu is needed and not assigned, CAL/32 will allocate 
temporary system files for logical units 
4, 5, 6, 8, 9, 11, 12 and 13. CAL/32 will delete and reallocate 
permanent files for logical units 2 and 3, provided they were not 
previously assigned and the DEL start option was specified. 


The files used for scratch, cross-reference, paging, forward 
equates, parameter control block (PCB) directory PCB name 
directory and error summarywill be allocated by CAL/32 as 
temporary operating system files if they are needed and were not 
previously assigned by the user. The logical units used are 
shown in Table 5-4. 


TABLE 5-4 CAL/32 LOGICAL UNITS 


me Gee GEES GRR fee! GE Ge OFS Cy ee EE Mm GEN ee EE ES GS Gee OD Gee EE Ge GY cme Ome GEN any SEE Gee GT ome Se Ge SE Ge OEE mee oem See OT Gn BOS Gm GEE Gee Gt Ort Gee ERT ee Ot ee Oe OD Oe" er Gm oe oe om a om ow an 


LOGICAL | ALLOCATED | REQUIRED 
LU | USE | RECORD | BY CAL/32 | FOR 


ree ree ene eee pres RS cree cms mes ee Oe eee wee ee Se ee ee ee et ee ER oe Oe eee wes ee re Oe oie es ee ee eee Oe 8D ee ee ee ee ee ee ee Os em ee OS aD ere eee Oe ee ee ee ee OD me Se aes Gee ome ee 
nae CES Gee Cae Gene GRAD GER Seed cere ane GES ek Seer Sen EP Ane Gees Gis GUNS Ge Gk NS Sms Gee Se See: Gee Ge Ge Gn Ke SS SE es et EE SU Se SE. GS Glew Gow GS See SEN Sus Ome See SES Ons Ere ens S0S Gee OS GND Sy OST Gan Soe ame See Ome mee 


Source input device. | 
The source input to be | 
assembled is read from | 
this device on pass | 
one. This device is re- | 
wound prior to each | 
subsequent pass unless | 
BATCH is specified and | 
the source input is not | 
on a random access | 
device, or scratch | 
(SCRAT) or pass pause | 
(PPAUS) is specified. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


108 T=16 
126 T=32 


If DEL 
specified 


Binary output device. All 
Assembled object pro- 
gram is written to this 
device on the last 


pass. 


Tf DEL 
specified 


Assembly listing output All 
device. Assembly list- 
ing is written to this 


device on the last pass. 
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TABLE 5-4 CAL/32 LOGICAL UNITS (Continued) 


ces Gs Gere came ete OS oe ee ee ee ee ee es Se ee OS es ee et ee ee et et ee Ge ee ee SS ee ee oe ee es ee es ee ee et om ee On oe ot et Ot we Se ee et Oe oe oe OF ee me 


LU 


> 


ny 


USE 


Source scratch device. 
The source input is 
copied to this device 
during pass one. The 
source input is’ read 
from this device on all 
subsequent passes. 


Symbol cross-reference 
scratch device. Cross~- 
reference information 
is built on this device 
during the last pass. A 
device assigned to this 
lu must support random 
access. 


Symbol table paging 
device, Symbol table 
information is paged to 
this device during all 
passes. A device 
assigned to this lu 
must support random 
access. 


Source library input 
device. Source inform- 
ation to be included in 
the main assembly is 
read from this device 
on each pass unless 
SCRAT or BATCH was: 
specified. Then the 
library is searched and 
read on pass one only. 


Forward equate scratch 
device. This lu can be 
used if forward refer- 
enced equates exist in 
the source input. This 
device must support 
random access. 


it 
It 
Hl 
It 
i 
il 
it 
ll 
Wi 
1) 
It 
i 
i) 
it 
it 
tt 
it 
1) 
tt 
HW 
li 
N 
ll 
ih 
i 
a 
u 
i] 
a 
It 
ik 
i 


LOGICAL | ALLOCATED | REQUIRE 
RECORD | BY CAL/32 | FOR 
80 | Yes | SCRAT 
| | BATCH 
| | 
| . 
| | 
j | 
| | 
| | 
256 | Yes | CROSS 
| | 
| | 
| | 
| | 
| | 
| [ 
| | 
512 | Yes | Insuffi- 
| | cient 
| | memory 
| | 
| | 
| | 
| | 
| i 
[ | 
80 | No | COPY 
[ | 
| [ 
| | 
| | 
| [ 
| |. 
| I 
| | 
| | 
| | 
256 | Yes | Forward 
| | equates 
| | 
| | 
| | 
| | 
| | 
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TABLE 5-4 CAL/32 LOGICAL UNITS (Continued) 


| | LOGICAL | ALLOCATED | REQUIRED 
LU | USE | RECORD | BY CAL/32 | FOR 


il 
i 
fl 
uw 
i 
tt 
HT] 
i" 
U 
i 
HN 
i! 
tt 
ft 
HI 
i] 
if 
i 
il 
i] 
Ul 
tt 
i] 
i! 
ii 
uN 
i 
" 
ii 
i 
" 
ii 
u 
" 
1) 
i 
i 
1) 
" 
it 
il 
7) 
i 
| 
it 
il 
i) 
il 
il 
" 
tt 
i 
ii 
il 
I 
i] 
H 
ii 
1] 
if 
i 
HI 
ii 


80 


KK 
oO 
n 


Error tabulation device. 
Error messages and 
their associated line 
numbers are written in 
binary to this device 
during the last pass 
and written to lu3 
after completion of the 
assembly and symbol 
table listing. 


Oo 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 
Copy file information | Yes 
directory. This device | 
must Support random | 
access, | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


np 


Parameter control block Yes 
(PCB) file directory 
scratch device. This 
device must support 
random access. 

13 PCB name directory Yes 
scratch device. This 
device must support 


random access. 


ed CED GRE STS Smet GE AUD SE GTS GEE GEN Gee Gay GEE GUN SFE ON Cm GOR SEE GED See Gne Geet GSP Gee Git GEO ET aoe GE. GER Gt oe O88 EEE Eee GEr OM OD Ors Gem BOF Gm OR OM SE Ee OF OF OF om Oo oO oF Om @ om > om Or Ot om 


= 
a) 


caesar ee ee ee ee ee ee mee eee ere cme ee ees owe eee ee ee wre es ee ee ee 
eee COE ee? ED Ce EEE SED Cem ne SED ee EES eee) cee OEE eee ee ceeees ame SEED come cee cee eee eo coe 


5.3.3 Starting Common Assembly Language (CAL/32) Using Command 
Command Substitution System (CSS) 


CAL/32 may be tailored for each installation's needs with the use 
of a simple CSS. The following sample CSS, named CAL.CSS for 
illustrative purposes, loads CAL/32; allocates desired memory 
workspace; assigns the source file to lul; and starts’ the 
assembly process with the desired START options. 


Example: 


LO CAL32,@2 

AS 1,@1.CAL 

ST ,NCROS DEL @3 @4 
SEXIT 
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The first statement in CAL.CSS loads CAL/32 with the @2 variable 
accepting the memory workspace allocation for the current session 
of CAL/32 assembly. The value of @2 is specified during CSS 
execution and is substituted within the CSS when the variables 
are expanded. (Variable substitution is discussed later in this 
section.) 


The second statement assigns the source file to lul and places 
the extension .CAL at the end of the source file being assembled. 
The source file is represented by the CSS variable @l. This 
sample CSS makes it unnecessary to enter in the source file with 
the CAL/32 extension identifier. The .CAL extension is added to 
the source filename automatically when the variable @1]1 is 
expanded. 


The third statement starts CAL/32 with the START options: NCROS 
and DEL. The @3 and @4 variables allow the user to do one of two 
things. The user has the option of either specifying two 
different START options or altering the START options already 
specified. 


The SEXIT ends CSS execution and returns control to the command 
processor. 


CAL.CSS is excuted in the following manner: 


CAL SOURCE,300,CROSS, SQUEZ 


Where: 

CAL ‘is the CSS call to commence execution of 
CAL/32. 

SOURCE is the name of the source file to be 
assembled, minus the .CAL extension. 

300 is the allocated memory workspace in kB 
desired for CAL/32 execution. This value 
varies in accordance with source program 
memory requirements. 

CROSS : alters the NCROS option of the START command, 
thus producing a cross reference of the source 
file assembled. 

SQUEZ performs a limited amount of space 
optimization of the source file during 
assembly. 


In the above CSS call, variable substitution is used to allow 
flexibility during execution. CSS variable substitution is 
represented in the CSS call statement as follows: 
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CAL @1,@2,@3,@4 


All CSS variables are expanded at the time of execution and 
replace the corresponding @n value in CAL.CSS 


Successful execution of CAL.CSS does not require that all 
variables be specified in the CSS call statement. For instance, 
CAL.CSS may be executed without memory workspace specified. 


Example: 
CAL SOURCE, , CROSS, NHPM 


In the above example, the @2 CSS variable is not specified, 
therefore, expanding only the @1l, @3 and @4 variables in CAL.CSS. 


CAL.CSS is only one example of the use of CSS calls to simplify 
the use of CAL/32. For more information pertaining to CSS 
programming, refer to the Multi-Terminal Monitor (MTM) Reference 
Manual. 


5.3.4 CAL/32 Assembler End of Task (EOT) Codes 


When an assembly terminates, an EOF code is passed to the 
operating system in the operand field of the Supervisor Call 3 
(SVC3) instruction. The meanings of the possible end of task 
codes are: 


END OF 
TASK CODE MEANING 

0 Assembly complete without errors. 

1 Illegal option passed with the START command. 
Assembly is aborted after logging the illegal 
options to the console. The user should 
retry. 

2 One or more errors detected during the 
assembly. This end of task code is also used 
if errors are detected in one or more programs 
of a batch assembly. 

3 Misplaced BEND. 

4 Symbol table overflow. 

5 A cross-reference option problem. Try to 


reassemble or use the NCROSS option to turn 
off the CROSS option. 
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A001 


A002 


A003 


BOO] 


B002 


cool 


DOO1] 


E001 


F001 
F002 


F003 


F004 


APPENDIX A 


COMMON ASSEMBLY LANGUAGE/32 (CAL/32) ERROR CODES 


the address 
the address 


the operand 
alignment 
alignment 
common mode 


data structure 


END placement 


missing operand 


register 
specification 


invalid source 
field 


invalid symbol 
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The address is out of range for the 
specified instruction format. 


The address is out of range for an 
RX2 instruction. 


The operand of a previously Squeezed 
instruction was changed making the 
Squeezed instruction invalid. 


The address of the operand is on an 
incorrect boundary for the 
instruction specified. 


An odd address used ina T constant 
location counter (LOC) was not even 
when the instruction was specified. 


An opcode that is not part of the 
common mode set is used in a common 
mode assembly. 


An illegal statement appears in a 
STRUC or COMN definition. 


An END statement was encountered 
within a STRUC or COMN definition or 
within an unterminated conditional. 


A required operand is missing. 


A register value is not in the 
range of 0 to 15, or an odd register 
value is used where an even value is 
required. 


Invalid label in the source field, 
a label in the name field is not 
followed by a space, or a required 
label is missing; e.g., on EQU. 


More than eight characters were 
specified in a symbol. 


F005 


F006 


F007 


F008 


F009 


F010 


F011 


F012 


EXTRN 


immediate field 


ENTRY 


delimiter 


invalid expression 


apostrophe 


invalid operand 


improper statement 


An invalid type for EXTRN; e.g., 
common block or EXTRN was used in an 
expression. 


The value of data is too large to 
fit into the immediate field. A 
fullword EXTRN is’ used in RIl 
instruction. A character string 
used as an immediate field is too 
long. 


A symbol declared as an ENTRY is 
undefined. Improper type for ENTRY; 
e.g., common block name. 


Operands are not separated by 
commas. Unrecognizable operator. 
The last operand is not followed by 
a CR or a blank. Unbalanced 
parentheses. Opcode is not followed 
by a space or a carriage return 
(CR). 


Expression uses common element names 
not in the same block. 


No ending apostrophe in C,D,E,F, 
H, P,U,X or Y constant. Tllegal 
character encountered in 
C,D,E,F,H,P,U,X or Y constant prior 
to the ending apostrophe. 


T constant was specified in TARGT 16 
assembly. Argument mode of Ji 
constant is not ABS, PURE or IMPURE. 
Illegal data specified in BDATA 
program. Fullword EXTRN used as an 
operand of DCZ. Value of DB operand 
must be absolute. Value of DS, DSF, 
DSH is illegal. Invalid symbol used 
for ENTRY name. Symbol used as 
ENTRY must be ABS, PURE, IMPURE, or 
Relocatable. Invalid symbol used 
for EXTRN name. Invalid data in 
BORG. Operand of CNOP or ALIGN is 
not absolute. Operand of DLIST is 
not absolute. 


Improper type for EXTRN operand; 
e.g., common block name. Transfer 
address on END statement is an 
improper type; e.g., EXTRN. Illegal 
operand on EQU. 
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F013 


F014 


F015 


I001 


MOO1 


M002 


0001 


POOL] 


P002 


ROO1 


Sool 


S002 


file descriptor 


missing string 


invalid character 


conditional 


symbol definition 


symbol definition 


illegal opcode 


location counter 


reentrancy check 


relocation error 


sequence check 


COPY 
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Syntax error on file descriptor (fd) 
Of a COPY, FCOPY, or CLIB statement. 


No characters between apostrophes of 
C,E,D,F,H,P,U,X or Y constant. 


Tllegal character encountered 
between apostrophes of an E or D 
constant. 


An ELSE or ENDC statement found 
without a matching IFx. 


The symbol in the name field is also 
used in the name field of another 
statement. The value or type of a 
symbol changed from its definition 
On a previous pass. (This can occur 
by illegal use of conditionals, ORG, 
DO, DS Or a misplaced SCRAT 
statement.) Forward referenced 
symbol used where a previously 
defined symbol is required. 


An attempt was made to redefine a 
symbol with an EQU that is the name 
field of a statement. 


The opcode used is totally 
unrecognizable or illegal for the 
specified TARGT. 


The location counter exceeded 2'® - 1 
on a TARGT-16 or 282-1 on a 
TARGT-32 assembly. 


The instruction attempts to modify 
PURE code. 


An invalid combination of 
relocatable terms in an expression. 
A relocatable operand follows a 
unary minus. 


The value in the sequence numbers 
field is not greater than the 
previous sequence number. 


COPY statement appears within a file 
being copied. An invalid symbol 
used as COPY operand. The operand 
of COPY is not followed by a_ space, 
comma or CR. 


S003 


S004 


S005 


TOOL 


TOO02 


TO003 


T004 
u00l1 
U002 


U003 


u004 


U005 


invalid option 
sequence 


invalid option 


PROG 


overflow 


floating point 


value 


divisor 
not used 


undefined symbol 


undefined symbol 


A COPY, PAUSE, MSG or DO 
statement immediately follows a DO 
statement. 


An argument is not absolute or 
exceeds 32,767. An argument of LCNT 
is not in the range of 10 to 99. An 
argument of WIDTH is not in the 
range of 64 to 132. An argument of 
TARGT does not evaluate to either 16 
Or 32. An argument of SQUEZ is not 
in the range of 1 to 99, 


Multiple PROG statements were 
encountered in a program. 


The intermediate or final result of 
an arithmetic expression exceeded 
2e-"il. 


An overflow occurred during 
conversion of floating point 
constant. 


The data item exceeds the range for 
specified type; e.g., X'12345'. 


A division by 0 is attempted. 


A referenced symbol is not defined 
in the program. 


An attempt was made to circularly 
define a symbol; e.g.: 


A EQU B 
B EQU A 


File specified as an operand of 
FCOPY, CLIB or COPY does not exist. 


Program name is not found in any of 
the PCB libraries. 
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APPENDIX B 
OBJECT CODE FORMAT 


Modules in object code format produced by Common Assembly 
Language/32 (CAL/32) are divided into records. Each record 
contains 126 bytes of information for 32-bit object code or 108 
bytes of information for 16-bit object code. The first four 
bytes of each record of the object code format are organized as 
follows: 


050-15 
SEQUENCE NUMBER CHECKSUM 
BITS: 0 15 16 31 


The sequence numbers are sequential negative integers -1, -2, -3, 
etc., represented in two's complement form. The first record in 
a program must have sequence number -1. Subsequent records must 
be in proper order to be loaded. 


The checksum is an exclusive OR sum of all halfwords in the 
record, except itself, exclusive ORed with a halfword of all 1's. 


The remainder of the record is a sequence of items; an item is a 
byte of loader information. There are two types of items: 
loader items and data items. Each loader item is followed by a 
certain number (which can be 0) of data items. The loader items 
and their meanings are listed in Tables B-1 and B-2. 
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TABLE B-1 32-BIT LOADER ITEM DEFINITIONS 


| LOADER | | NUMBER OF DATA | 
ITEM | MEANING | ITEMS FOLLOWING | 
—t — FS on 8-8 ee ee 2-8 nd 8 | 
0 End of record None 
1 End of program None 
2 Reset sequence number None 
3 Block data indicator 8-byte name, 


3-byte displacement, 
any absolute data 
item (20-5B) 


| 

| 

| | | | 
| | | | 
| | | | 
| | | 
| | | | 
| | | | 
| | | | 
| 4 | Absolute program address | 3-byte address | 
| 5 | Pure relocatable program | 3-byte address | 
| | address | | 
| 6 | Impure relocatable program | 3-byte address | 
| | address | | 
| 7 | 2 bytes of pure relocatable | 2-byte address | 
| | data | | 
| 8 | 2 bytes of impure | 2-byte address | 
| | relocatable data | | 
9 | 4 bytes of pure relocatable | 4-byte address | 
| | data | | 
| A | 4 bytes of impure | 4-byte address | 
| | relocatable data | | 
| B | Common reference | 8-byte address | 
| | | 3-byte displacement | 
| C | EXTRN | 8-byte name, fol- | 
| | | lowed by item 4, | 
| | | 5, or 6 | 
| D | ENTRY | 8-byte name fol- | 
| | | lowed by item 4, | 
| | | 5, or 6 | 
| E | Common definition | 8-byte name fol- 
| | | lowed by a 3-byte | 
| | | length | 
| F | Program label | 8-character name | 
| 10 | 3 bytes absolute and 3 | 6 bytes | 
| | bytes pure relocatable | | 
| 11 | 3 bytes absolute and 3 | 6 bytes | 
| | bytes impure relocatable | | 
| 12 | Load program transfer | Item 4, 5, or 6 | 
| 13 | Define start of chain | Item 4, 5, or 6 | 
| | (reference) | | 
| 14 | Load chain definition | Item 4, 5, or 6 | 
| | address | | 
| 15 | 2 bytes absolute and 2 | 4 bytes | 
| | bytes pure relocatable | | 
| 16 | 2 bytes absolute and 2 | 4 bytes | 
| | | | 


bytes impure relocatable 
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B-1 32-BIT LOADER ITEM DEFINITIONS (Continued) 


ITEM 


28. TE en AED ED IW. SITE GTS GEE RD GEE Geom SOTD GU GY SEED GTS STS MEN ORRe ORES ET OS SES GT men ee ee Ser Ge SWS Grr Se aes SEP OSE OS OOS ee SE Eee eee Oe Oe mee Os Se SS eet me Gee ee Sen See Ete Oe Ome Oe Ge ee ome 
Soon Sean Snes aPee SUM eee Sat Se Se ne Set ee Ge Se Ame SS SMS SAS SCS Gee Sa aN SS SN SN SEN Se SS OS Sewy D See as Oe SE OMS AES SD Gene Sam Sek Son SST ORS HET SE SUS ES Chey GES CS auan GAD Eine Gam Gant Gee GS cme es ene 


5D 


Short form EXTRN 


Length of impure and pure 
segments 


Perform fullword chain 
Perform halfword chain 
No operation 

2-byte pure translation 
table address 

2-byte impure translation 
table address 

Not used 

l-byte absolute data 

2 bytes absolute data 

4 bytes absolute data 

6 bytes absolute data 

8 bytes absolute data 


120 bytes absolute data 


Define pure location counter 


Define impure location 
counter 


No operation 
Load program address 


2 bytes relocatable data 
4 bytes relocatable data 
2 bytes ABS/ 2 bytes 
relocation 

3 bytes ABS/ 3 bytes 
relocation 

Load translate table 
address 
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NUMBER OF DATA 
ITEMS FOLLOWING 


8-byte name and 

Item 4, 5 or 6 
3-byte impure length 
and 3-byte pure 
length 

None 

None 

None 

2 bytes 


2 bytes 


N/A 

] byte 
2 bytes 
4 bytes 
6 bytes 
8 bytes 


120 bytes 
l-byte location 
number 
8-byte 
8~-byte 
1-byte 
number 
8-byte 
8-byte 
None 
1-—byte 
number 
3-byte 
address 
2 bytes 
4 bytes 
4 bytes 


section name 
pool name 
location 


section name 
pool name 


location 


relocate 


6 bytes 


1-byte location 
number 
2-bytes data 


TABLE B-l 32-BIT LOADER ITEM DEFINITIONS (Continued) 


| LOADER | | NUMBER OF DATA 
ITEM | MEANING | ITEMS FOLLOWING 


f+ —t—_4—_ 4-44 ee ee et eee 
Sees ee ee ee Se Gee eee Geet Sk Ses Sees et Oe SS Gee See SPSS ae Sies Sas Get ONE Ge Ge GS ES SES Se Saw Sao See SS St Se SS SA SS Se GE SES See Sat SS ne Sa Gat Ses Se! on GOS One SUS Se Sos ae SMS Soe Sa Se Some aot 


Extended EXTRN reference | 8-byte external 

| symbol name 

| l-byte flag 

| xxxx xx00 standard 

l EXTRN 

| xxxx xx0l1 weak 

l EXTRN 

| xxxx xxl0 include 

| EXTRN 

| 4-byte offset 

| Item 4, 5 or 6 
Extended entry | 8-byte entry symbol 
| 
| 
| 
| 
| 
| 
| 
| 
| 


l-byte flag 
xxxx xx00 standard 

entry 
XXXxX xx0l data 

entry 
XXXX xx1l0 weak 

entry 
Item 4, 5 or 6 
1l-byte length 
1-80 characters 
of command 


67 Link commands 


fon) 
fey) 


| LOADER | | NUMBER OF DATA | 
ITEM | MEANING | ITEMS FOLLOWING | 


End of record 

End of program 

Perform chain 

Toggle absolute/relocatable 
mode 

Transfer address 

Load program address (ORG) 
Load reference address 
Load definition value 

2 bytes absolute data 

2 bytes relocatable data 
4 bytes absolute data 

2 bytes absolute and 2 
bytes relocatable data 
EXTRN reference 


2-byte address 
2-byte address 
address 
2-byte address 
2 bytes data 
2 bytes data 
4 bytes data 
4 bytes data 


Q WDrPrwuooO dS fp WNHHO 
bo 
] 
oO 
Ke 
ct 
@ 


6-byte name 
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TABLE B-2 16-BIT LOADER ITEM DEFINITIONS (Continued) 


En Ce COT) TS Cee, SN ET Mee Gen SRE SE Gee GIES EO EE ETE Ga arew men GIs Ge eee Mi OSS GET ee OTT GET CEP Gr Grn Gat Ger Gre GT Gute Ges OUP em Gee OEP GR Gee aun GUE ame Gres Gee Get GE em GEE OH a Oo OE 


| LOADER | | NUMBER OF DATA | 
| ITEM | MEANING | ITEMS FOLLOWING | 
| mamemesmanes see see eee sess sees eseseeeessees | 
| D | ENTRY definition | 6-byte name | 
| E | Decode next item | Next item | 
| E0 | Declare common block | 6-byte name | 
| | | 2-byte size | 
| El | Load common block | 6-byte name | 
| | definition value | 2-byte offset | 
| E2 | 2 bytes absolute block data | 6—byte name | 
| | | 2-byte offset | 
| | | 2 bytes data 
| E3 | 4 bytes absolute block data | 6-byte name | 
| | | 2-byte offset | 
| | | 4 bytes data | 
| E4 | Reset sequence number to -1 | None | 
| E5 | 1-byte absolute data | l-byte data | 
| E6 | l-byte absolute block data | 6—byte name | 
| | | 2-byte offset | 
| | | l-byte data | 
| F | Program label | 6-byte name | 


ee Mie GS Ges GR SEU Gane OE Ey SEP GD Gey Gen CoeE GUN SE Gee SOF eee eee Se Se. Gee EE EE Bee Se GY GE Gee OHS ES BT Ge GE Sem CD tes GFP GEe Gm GeE GD Get wen SEE 8 see ae eee eee ee ee ee es 


Note that item E is actually 
on the item it 


All items are given in hexadecimal. 
a compound item whose interpretation depends 


follows. Item E and the following item are considered a_ single 
control item and cannot be split across object records. This 
effectively allows more than 16 different control items though 
most of them require only one nibble. 
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A 


ABS instruction 
Absolute instruction. 
ABS. 
Add immediate short 
instruction 
Address constants 
types 
Address operation 
instructions 
ALIGN instruction 
And address immediate 
instruction 
APU instruction 
APU option 
start options 
Arithmetic expressions 
Arithmetic operators 
Assembler control 
instructions 
batch assembly 
copy 
copy library 
end 
file copy 
high performance method 
lower-case 
message 
no lower-case 
no squeeze 
pass pause 
pause 
scratch 
sequence checking 
squeeze 
squeeze related 
target 
unreferenced externals 
Assembler instructions 
absolute 
align 
common mode 
compound conditional 
conditional no operation 
data definition 
data entry 
define byte 
define command 
define constant 
define list 
define storage 


See 


equate 

external 

high performance method 
impure 

include 
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Assembler instructions 
(Continued) 
LOC 
no squeeze 
origin 
pure 
simple IF 
symbol definition 
weak entry 
weak external 
Assembly listing 
cross reference listing 
object program statements 
source program statements 
symbol cross-reference 
table 
Auxiliary processing unit. 
See APU. 


B 


Batch end instruction. See 
BEND. 

BATCH instruction 

BDATA instruction 

BEND instruction 

Block data instruction. 
BDATA. 

Block origin instruction. 


See 


- See BORG. 


BORG instruction 
Branch and link instructions 


Cc 


CAL instruction 
CAL/32 
machine instructions 
3200MPS Family of 
Processors 
3280 System 
mnemonics 
Series 3200 Processors 
summary 
operating instructions 
start options 
task establishment 
Character constants 
CLIB instruction 
CNOP instruction 
Comment statements 
examples 
Common Assembly Language/32. 
See CAL/32. 
Common instruction. See COMN. 
Common mode assembler 
instructions 
Common mode immediate 
operations 


3-52 
3-60 
3-53 
3-52 
3-71 
3-30 
3-35 
3-35 


3-83 
3-81 
3-81 


3-81 


IND-1 


Common mode programming 
COMN instruction 
Compound conditional 
instructions 
Conditional assembly 
instructions 
compound conditional 
do 
simple IF 
Conditional branch 
instructions 
branch and link 
Conditional no operation 
instruction. See CNOP. 
Constant types 
address 
character 
decimal string 
floating point 
hexadecimal 
integer 
Content control instructions 
cross reference 
error list 
freeze 
list 
list conditionals 
list macro 
list unreferenced symbols 
no cross 
no freeze 
no list 
no list conditionals 
no list macro 
no list unreferenced 
symbols 
no processor specific 
warning 
no warning 
processor specific 
warning 
warning 
COPY instruction 
Copy library instruction. 
See CLIB. 
CROSS instruction 
Cross reference instruction. 
See CROSS. 


D 


DAC instruction 

DAS instruction 

Data definition instructions 
common mode data 
definition 
define constant 
define storage 

Data entry instruction. See 

DNTRY. 

DB instruction 

pC instruction 

DCF instruction 
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Decimal string constants 3-47 
packed 3-47 
unpacked 3-47 


Define address length 

constant instruction. See DAC. 
Define address length 

storage instruction. See DAS. 
Define byte instruction. See 


DB. 
Define command instruction 3-52 
Define constant instruction 
fullword alignment 3-39 
halfword alignment 3-39 
Define list instruction. See 
DLIST. 
Define storage instruction 
fullword alignment 3-37 
halfword alignment 3-37 
DLIST instruction 3-51 
DNTRY instruction 3-36 
DO instruction 3-72 
DS instruction 3-37 
DSF instruction 3-37 
DSH instruction 3-37 
E 
EJECT instruction 3-78 
ELSE instruction 3-68 


End condition instruction. 
See ENDC instruction. 
END instruction 3-56 
End of task codes. See EOT. 
End structure instruction. 


See ENDS. 
ENDC instruction 3-69 
ENDS instruction 3-74 
ENTRY instruction 3-34 
EOT codes 5-13 
EQU instruction 3-30 
Equate instruction. See EQU. 
ERLIST instruction 3-80 
Error checking 4-5 
Error codes A-1 
Error list instruction. See 

ERLIST. 

Error squeeze instruction. 

See ERSQZ. 

ERSQZ instruction 3-63 
Expressions 

evaluations 2-2 

Extended branch instructions 3-23 
Extended branch mnemonics 3-23 
External instruction. See 

EXTRN. 

EXTRN instruction 3-34 

F 

FCOPY instruction 3-58 
File copy instruction. See 

FCOPY. 3-58 
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Floating point constants 
double precision 
internal representation 
single precision 

Floating point registers 
double precision 
single precision 

Format control instructions 
eject 
line count 
space 
width 

Freeze instruction. 

FREZE. 
FREZE instruction 


See 


G 


Global symbols 
ADC 
LADC 


Hardware 
relocation 
segmentation 
Hexadecimal constants 
High performance assembly. 
See HPM,. 
High performance method 
assembly 
instruction 
memory requirements 
Memory utilization 
performance 
HPM instruction 


I,J,K 


I/O operations 
IF instruction 
conditional 
simple 
Implicit symbols 
character 
decimal 
hexadecimal 
IMPUR instruction 
Impure instruction. See IMPUR. 
INCLD instruction 
Include instruction. 
Input/output processor. 
IOP. 
Instruction execution 
order 
Instruction formats 
16-bit 
32-bit 
abbreviations 


See 


reg & index storage/reg 
& index storage 
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See INCLD. 


3-46 
3-47 
3-46 


1-3 
1-3 


3-78 
3-78 
3-78 
3-78 
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Instruction formats 
(Continued) 
register and immediate 
register-to-register 


register/immediate one 
register/immediate two 
register/indexed storage 
register/indexed storage 
one 
register/indexed 
three 

register/ indexed 
two 

short form 


storage 


storage 


variations 
Instruction statements 

assembler 

character position 

fixed format 

free format 

machine 

restrictions 
Instruction variations 
Instructions 

compare 

conditional branch 

I/O 

load PSW 

simulate interrupt 

store 

test 

usual extended branch 

mnemonics 
Instructions for data 
structures 

structure definition 

Structure initialization 
Integer constants 

alignment 

examples 

range 
IOP 

instructions for 3260MPS 

System 


L 


LCASE instruction 
LCNT instruction 
Line count instruction. 
LCNT,. 
List conditionals 
instruction. See LSTC, 
LIST instruction 
List macro instruction. 
LSTM. 
List unreferenced symbols 
instruction. See LSTUR. 
Listing control instructions 
content control 
format control 
listing identification 


See 


See 
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3-79 


3-78 
3~77 
3-77 
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Listing identification 
instructions 
program 
title 
LOC instructions 
absolute 
align 
conditional no operation 
impure 
origin 
pure 
Location counter. 
Logical expressions 
Logical unit assignment 
Lower-case instruction. 
LCASE. 
LSTC instruction 
LSTM instruction 
LSTUR instruction 


See LOC. 


See 


M 


Machine instructions 
16-bit 
CAL/32 
mnemonics 
Main memory 
accessing 
Memory addresses 
16-bit processors 
32-bit processors 
Message instruction. 
Mixed expressions 
Mixed mode computations 
MSG instruction 


See MSG. 


Name field 
characters 
examples 
restrictions 

NAPU instruction 

NCROS instruction 

NFREZ instruction 

NHPM instruction 

NLCASE instruction 

NLIST instruction 

NLSTC instruction 

NLSTM instruction 

NLSTU instruction 

No cross instruction. 

NCROS. 
No freeze instruction. 
NFREZ. 

No high performance 

assembly. See NHPM. 

No list conditionals 

instruction. See NLSTC. 

No list instruction. See 

NLIST. 
No list macro instruction. 
See NLSTM. 


See 


See 


IND-4 


No list unreferenced symbols 
instruction. See NLSTU. 

No lower-case instruction. 
See NLCASE. 

No processor specific 
warning instruction. 
See NPWRN. 

No sequence checking 
instruction. See NOSEQ. 

No squeeze instruction. 
NOSQZ. 

No warning instruction. 
NWARN. 

NOCAL instruction 

NORX3 instruction 

NOSEQ instruction 

NOSQZ instruction 

NPWRN instruction 

NUREX instruction 

NWARN instruction 


See 


See 


e) 


Object code format 
Operand field 
reg & index stor/reg & 
index stor instruction 
register-to-register 
instruction 
register/immediate 
instruction 
register/indexed storage 
instruction 
Operation field 
examples 
mnemonics 
restrictions 
ORG instruction 
Origin instruction. See ORG. 


P 
Packed decimal string 
constant 
examples 


internal representation 
Pass pause instruction. See 
PPAUS,. 
PAUSE instruction 
PPAUS instruction 
Processor specific warning 
instruction. See PWRN. 
PROG instruction 
Program instruction. See 
PROG. 
Program status word. 
PSW. 
Programs 
absolute 
relocatable 
PSW 
condition code 
location counter 
status descriptor 


See 
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PURE instruction 3-52 
PWRN instruction 3-80 
Q 
Quantities 
absolute 2-2 
relocatable 2-2 
R 


Reg/index storage one 
instruction (32-bit). See RXl. 

Reg/index storage three 
instruction (32-bit). 
See RX3. 

Reg/index storage two 
instruction (32-bit). 
See RX2. 

Register and immediate 
instruction. See RI. 
Register and immediate 
instruction (32-bit). 

See RIl. 

Register and immediate 
instruction (32-bit). 
See RIZ. 

Register and index/register 
and index instruction. 

See RXRX,. 

Register-to-register 
instruction. See RR. 

Register/indexed storage 
instructions. See RX. 

Restricted symbols 

ABSTOP 
ADC 
IMPTOP 
LADC 
PURETOP 
RI instructions 
operand representation 

RI1l instruction 

RI2 instruction 

RR instructions 

16-bit 

32-bit 

operand representation 
RX instructions 

16-bit 

32-bit 

operand representation 

RX1 instruction 

RX2 instruction 

RX3 instruction 

RXRX instruction 

operand representation 


one 


two 
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SCRAT instruction 
Scratch instruction. 
SCRAT. 


See 
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Sequence checking 

instruction. See SQCHK. 

Series 3200 Processors 
machine 

instructions/mnemonics 

SF instructions 
16-bit 
32-bit 

Short form instructions. 

See SF. 

Source statements 
comment 
instruction 

SPACE instruction 

Special instructions 

SQCHK instruction 

Squeeze instruction. 

SQUEZ. 

Squeeze related instructions 
error squeeze 
no RX3 

SQUEZ instruction 

START command 

Starting CAL/32 
assigning logical units 
end of task (EOT) codes 
error codes 
object code format 
using CSS 

Statements 
assembler 
machine 

String-processing instruction 

STRUC instruction 

Structure definition 

instructions 
common instruction 
end structure instruction 
structure instruction 

Structure initialization 

instructions 
block data 
block origin 
Structure instruction. 
STRUC. 

Subroutines 
branching to 
returning from 

Symbol definition 

instructions 

Symbols 
global 
implicit 
restricted 

Symbols and expressions 
examples 


See 


See 


System architecture 
multiprocessing 
uniprocessing 


T 


Target instruction. See 
TARGT. 
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TARGT instruction 3 
Task establishment 5 
Temporary storage 

types 1- 
TITLE instruction 3 


U,V 


Unpacked decimal string 
constant 
examples 3~49 
internal representation 3-48 
Unreferenced externals 
instructions. 
See UREX and NUREX. 
UREX instruction 3-66 
Usual extended branch 
mnemonics 3-25 


W,X,Y,2Z 


WARN instruction 3-80 
Warning instruction. See WARN. 
Weak entry instruction. See 

WNTRY. 
Weak external instruction. 

See WXTRN. 
WIDTH instruction 3-78 
WNTRY instruction 3-35 
WXTRN instruction 3-35 


3200MPS Family of Processors 
machine 
instructions/mnemonics 3-20 
3260MPS System 
IOPs 3-29 
3280 System 
usual extended branch 
mnemonics 3-25 
CAL/32 machine 
instructions 3-27 
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PUBLICATION COMMENT FORM 


We try to make our publications easy to understand and free of errors. Our users are an integral source 
of information for improving future tevisions. Please use this postage paid form to send us comments, 
corrections, suggestions, etc. 


1. Publication number 


2. Title of publication 


3. Describe, providing page numbers, any technical errors you found. Attach additional sheet if 
necessary. _. 


4. Was the publication easy to understand? If no, why not? 
5. Were illustrations adequate? _ 
6. What additions or deletions would you suggest? a 
7. Other comments: 
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Company 
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